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About This Manual 


This manual explains how to create and manage network application definitions, and 
manage network services on the CONTROL DATA® Network Operating System/Virtual 
Environment (NOS/VE) using the CDC® Control Data Distributed Communications 
Network (CDCNET). 


Audience 


This manual is for the system analyst who is responsible for network management on 
NOS/VE. It is assumed that you are either an experienced NOS/VE analyst or you 
have completed the sequence of NOS/VE hardware and software courses (including the 
NOS/VE Analysis course) and the CDCNET courses offered by Control Data. It is also 
assumed that you have a working knowledge of the System Command Language (SCL) 
as described in the NOS/VE System Usage manual. 


Conventions 


This manual documents commands and subcommands using a format similar to the 
format used in the NOS/VE Commands and Functions manual. In addition, the 
following conventions are used: 


Boldface In command format descriptions, command names, subcommand names, 
and required parameters are shown in boldface type. 


Ttalics Optional parameters in a command or subcommand format description 
are shown in italics. 


Vertical bar A technical change is indicated by a vertical bar in the margin next to 
the change. 


Numbers All numbers are decimal unless otherwise noted. 
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Submitting Comments 


There is a comment sheet at the back of this manual. You can use it to give us your 
opinion of the manual’s usability, to suggest specific improvements, and to report 
errors. Mail your comments to: 


Control Data Corporation 

Technology and Publications Division ARH219 
4201 North Lexington Avenue 

St. Paul, Minnesota 55126-6198 


Please indicate whether you would like a response. 


If you have access to SOLVER, the Control Data online facility for reporting problems, 
you can use it to submit comments about the manual. When entering your comments, 
use NVO (zero) as the product identifier. Include the name and publication number of 
the manual. 


If you have questions about the packaging and/or distribution of a printed manual, 
write to: 


Control Data Corporation 
Literature and Distribution Services 
308 North Dale Street 

St. Paul, Minnesota 55103 


Or call (612) 292-2101. If you are a Control Data employee, call (612) 292-2100. 


CYBER Software Support Hotline 


Control Data’s CYBER Software Support maintains a hotline to assist you if you have 

trouble using our products. If you need help not provided in the documentation, or find 
the product does not perform as described, call us at one of the following numbers. A 

support analyst will work with you. 


From the USA and Canada: (800) 345-9903 


From other countries: (612) 851-4131 
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Introduction to Network Management 1 


NOS/VE network management, as described in this manual, refers to the performance 
of network-related activities on the NOS/VE operating system. NOS/VE network 
management functions include: 


@ Maintenance of network applications, as described in chapters 2 through 5. 


e@ Activation and deactivation of certain host-based parts of the CDCNET network 
software, as described in chapter 6. 


© Site-tailoring of NAM/VE attributes, as described in chapter 7. 


© Controlling the action of the Queue File Transfer Facility (QTF) in its 
store-and-forward function, as described in chapter 8. 


Although NOS/VE network management responsibilities include maintenance of some 
host-based CDCNET software, they do not include CDOCNET management as such. For 
information on CDCNET management and administration, refer to the appropriate 
CDCNET documentation. 


Network Application Programs 


NAM/VE is part of the NOS/VE operating system and provides the interface between 
the NOS/VE operating system and CDCNET. All network application programs run 
under NAM/VE. 


Network applications provide various network services such as interactive and batch 
terminal support for NOS/VE. (Note that in a dual-state environment, interactive 
terminal support can also be provided through the NOS or NOS/BE partner system.) In 
a multihost network, network services can also be established to transfer jobs and files 
between mainframes in the network. 


CDCNET Management Entities 


CDCNET software includes a number of application programs that support CDCNET 
functions. These programs are called Management Entities (MEs). 


The NOS/VE network manager is responsible for activating certain MEs that reside on 
the NOS/VE host. Chapter 6 describes these MEs and their commands. 


NAM/VE Attributes 


You can control aspects of NAM/VE operation that affect performance and the use of 
resources with the CHANGE_NAM_ATTRIBUTES and DISPLAY_NAM_ ATTRIBUTES 
commands. Chapter 7 describes these commands in detail. 
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MANAGE _STORE _FORWARD_NETWORK Utility 


A site administrator can use the MANAGE_STORE_FORWARD_ NETWORK utility to 
create a store-and-forward network file. This network file contains mainframe name 
substitutions required to forward a queued file from one NOS/VE system to another 
NOS/VE system through a non-VE system. Chapter 8 describes the MANAGE_ 
STORE_FORWARD_NETWORK utility in detail. 
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Understanding Network Applications 2 


Introduction 


This chapter explains network application concepts and describes the system-defined 
network applications that execute on NOS/VE. 


The default application definition for each system-defined network application described 
in this chapter is listed in appendix C. The NOS/VE commands used for installing the 
system-defined network applications are listed in chapter 5. See chapter 3 for 
instructions on how to use the MANAGE_NETWORK_ APPLICATIONS (MANNA) 
utility to change the default network application definitions. 


NOTE 


You should be familiar with the concepts and terms presented in this chapter before 
using the MANAGE_NETWORK_APPLICATIONS utility. 
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Network Application Concepts 


Network Application Concepts 


Within a CDCNET configuration, various types of communications media enable you to 
physically interconnect NOS/VE and other mainframe hosts, terminals, peripheral 
devices, and CDCNET device interfaces (DIs) into networks. DlIs facilitate 
communication among mainframes, terminals, and peripheral devices in a network. For 
more information about DIs, see the CDCNET manuals listed in appendix. B. 


A network application can be structured as a single program, a sequence of programs, 
or a set of concurrent programs. In this manual, each execution of an application is 
referred to as an instance of that application. 


Within a multihost network, NAM/VE allows an application to communicate with 
another application on any mainframe host connected to the network. NAM/VE also 
provides application-to-application communication within the same NOS/VE system. 
Figure 2-1 illustrates both concepts. The following sections explain general network 
application concepts. 


NOS/VE NOS/VE 


Application 
Cc 


INAM/VE 
| | 


Line Interactive interactive 
Printer Terminal Terminal 


Figure 2-1. Network Connections | 


Client and Server Network Applications 


A network application is classified as either a client application or a server application 
by the role the application plays in establishing a network connection. The client/server 
classification is relevant only to the creation of a network connection. Once the 
connection is successfully established, all applications have the same privileges. 
However, the applications may choose to retain their client or server characteristics 
and restrict operations accordingly. The client/server classification applies only to a 
particular network connection. An instance of an application that uses multiple 
connections may be the client for one connection and the server for a different 
connection. 
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Single-Connection Applications 


A client application is any application authorized to create a network connection to 
access a service provided by a server application. The server application can either 
accept or reject a connection request. If the request is accepted, the server application. 
provides a service to the client application via the network connection. 


For example, when an interactive terminal user enters the CDOCNET command: 
create_connection nosve 


a CDCNET client application in the DI connected to the user’s terminal executes the 
command, thereby requesting a connection to the Timesharing server application with 
the registered title of NOSVE. An interactive job starts in the NOS/VE host. This job 
is an instance of the Timesharing server application. 


The rest of this example illustrates the concept of an instance of an application being 
the server for one network connection and the client for another connection. Assume 
the interactive terminal user wants to use the Permanent File Transfer Facility (PTF) 
to transfer files to or from another host: in the network. In this case, the interactive 
job (instance of the Timesharing application) requests a network connection to the PTF 
server application in the other host. The instance of the Timesharing application which 
is the server for the first connection is now the client for the second connection. 


Single-Connection Applications 


A single-connection application is an application that supports one connection for each 
instance of the application. Since several instances of an application can be active at 
one time, a single-connection server application can provide service to several clients 
simultaneously, as shown in figure 2-2. 


Application 


1st Instance of 2nd Instance of 3rd Instance of 
Application Application — Application 


Figure 2-2. Single-Connection Application 
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Multiconnection Applications 


Multiconnection Applications 


A multiconnection application supports multiple connections for each instance of the 
application. In this case, there is usually only one instance active at any given time 
(see figure 2-3). A multiconnection application is used if connections to the application 
must interact (for example, to exchange messages between connections) or if operations 
must be synchronized between connections (for example, to update a data base). 


Application 


ist Instance of 
Application - 


Figure 2-3. Multiconnection Application 


Network Address Components 


Each application that can access CDCNET has a network address. This address locates 
the application within the network. The address is used to route messages to the 
application. A network address consists of three parts: 


@ A network identifier 
@ A system identifier 
@ An application identifier 


The network identifier and the system identifier uniquely identify the NOS/VE system 
within the CDCNET network. The network identifier is defined during network 
configuration. (For more information on defining a network configuration, refer to the 
NOS/VE System Performance and Maintenance manual, Volume 2.) The NOS/VE 
system identifier is created automatically by NAM/VE from the CPU model and serial 
numbers when NAM/VE is activated. 


The application identifier indicates a specific application within the NOS/VE system. . 
When you define client and server applications, you can specify either fixed application 
identifiers or you can allow NOS/VE to assign variable identifiers. Fixed and variable 
application identifiers are explained in chapter 3. 
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Server Application Job 


A server application job is defined as the job in which an instance of a server 
application occurs. It is also the job that provides the server application’s service to a 
client connection. 


A server application must be activated before any client can establish a connection to 
the server. A server application is activated by the ACTIVATE_SERVER subcommand. 
See chapter 4 for a description of this MANNA subcommand. 


For a server application to service a client connection, the following must be true: 


@ The network address at which the server application resides must be active (open) 
so a connection request can be received. 


e An instance of the server application (a server application job) must be executing. 


NAM/VE supports two types of server applications: NAM-initiated server and 
user-initiated server. The server application types are specified on the NAM_ 
INITIATED parameter of the DEFINE_SERVER subcommand. This subcommand is 
described in chapter 4. These two types of server applications differ in the way in 
which the server job is initiated and the conditions under which the server’s network 
address becomes active. The following two sections explain these differences. 


User-Initiated Server Applications 


For a user-initiated server, the server application job is initiated by a command for a 
specific application that is executed by an authorized user. The server job then notifies 
NAM/VE of its existence as an instance of a server application and waits for 
connection requests. When at least one instance of the server job is executing, the 
network address of a user-initiated server job is active. 


Except for the Timesharing application, all of the system-defined applications are 
user-initiated. The activation commands that initiate server eppcasian jobs are 
described in chapter 5, Installation Commands. 


NAM-Initiated Server Applications 


For NAM-initiated server applications, the server’s network address is active when the 
server’s state is activated by an ACTIVATE_SERVER subcommand. When a 
NAM-initiated server is defined by a DEFINE_SERVER subcommand, a sequence of 
SCL commands is specified that initiates the server application job, once the job is 
submitted by NAM/VE to the system. (See the SERVER_JOB server application 
attribute described in table 3-4.) 


NAM/VE waits for a connection request for the server application. Then, based on 
whether the server application is a single-connection or multiconnection application, 
NAM/VE submits a server job to the system. 


For a single-connection server application, NAM/VE initiates a server job for each 
connection request. (The Timesharing application is an example.) For a multiconnection 
server application, NAM/VE initiates a server job only when the server jobs currently 
executing cannot service more connections. 
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NAM-Initiated Server Applications 


The following table summarizes the major differences between user-initiated and 
NAM-initiated server jobs. 


Table 2-1. User-Initiated and NAM-Initiated Server Job Comparison 
User-Initiated Server Job NAM-Inititated Server Job 


Validation information is specified in a Client can supply the validation information. - 
LOGIN command executed by the user. 


Server jobs are initiated by a command NAM/VE initiates server jobs as needed t 


executed by the user. service clients. 
The content within the server job is The content within the server job is 
unknown to NAM/VE. specified to NAM/VE via the MANAGE_ 


NETWORK _APPLICATIONS utility. 


A server job must be initiated before a A client must initiate a connection before 
client’s request can be serviced. NAM/VE executes a server job to service 
the connection. 


NAM/VE registers a server’s titles in NAM/VE registers a server’s titles in the 
the network directory when the first network directory when the server 
instance of the server job is initiated. application is activated. 
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Network Application Validation 


- In a NOS/VE system, users are assigned passwords to access the system. Each user is 
uniquely identified by a family and user name, and is assigned certain privileges and 
capabilities. 


In a like manner, a network application is uniquely identified by an application name 
and network address, and can also be assigned a set of privileges and capabilities. 


NAM/VE provides two levels of application validation. 


The first level of application validation is through the MANAGE_NETWORK_ 
APPLICATIONS utility. You use this utility to verify that a program is an authorized 
network application and to allow the program to use the network address and other 
attributes of the application. The MANAGE_NETWORK_APPLICATIONS utility gives 
you the following client and server attributes that specify how the validation is 
performed. 


Server Attributes: 


SERVER_CAPABILITY 
SERVER_RING 
SERVER_SYSTEM_ PRIVILEGE 


Client Attributes: 
CLIENT_CAPABILITY 


CLIENT_RING 
CLIENT_SYSTEM_ PRIVILEGE 
NOTE 


The SERVER_SYSTEM_PRIVILEGE and CLIENT_SYSTEM_ PRIVILEGE attributes 
are not operational for the current release of NOS/VE. 
See chapter 3 for more information about these attributes. 


The second level of application validation must take place for network applications to 
communicate through NAM/VE. This validation takes place in one of two ways: 


@ When a NAM-initiated server job is submitted to the NOS/VE system, the server 
application validates the job. This is called server job validation. 


@ When a client application requests a connection to a server application, the server 
application validates the connection request. This is called connection request 
validation. 


The next two sections discuss this second level of application validation. 
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Server Job Validation 


Like all NOS/VE jobs, the server job must validate itself to the system. The server job 
validation: 


@ Identifies the user for whom the server job is executed. 
© Determines the activities to be performed within the job. 
® Establishes the limits on resources the server job uses. 


The validation information for server jobs is obtained from the LOGIN command. 
However, the source of information for the LOGIN command varies, depending on 
whether the server job is user-initiated or NAM-initiated. 


For a user-initiated server job, you must specify validation information in a LOGIN 
command. The LOGIN command must also be the first command in the job file. 


For a NAM-initiated server job, the user validation information is also contained in the 
LOGIN command. It too must be the first command in the job. However, the 
MANAGE_NETWORK_APPLICATIONS utility provides the following two options: 


® Validation information can be imbedded in the server- job definition. 


® Validation information can be obtained by NAM/VE from the chen prior . to. 
initiating the server job. 


For more information on server job validation, see the description of the SERVER_ 
JOB_VALIDATION_SOURCE attribute in table 3-4. 


NOTE 


If the validation source is the server job, the first command in the job must be a 
LOGIN command. If the validation source is the client, the server job cannot contain a 
LOGIN command. 


Client-Supplied Validation 


If the client application supplies the user validation information, NAM/VE initiates a 
dialog with the user as follows: 


Enter validation for service access. 
User: 

Password: 

Family: 


NAM/VE concatenates the login responses to form a parameter list for a LOGIN 
command. This parameter list follows standard SCL syntax rules. If the client does not 
supply a family name, NAM/VE uses the system default family. If the client specifies 
more than one parameter in a single response, NAM/VE assumes that all required 
parameters are entered and stops prompting. 


In addition to supplying the user name, password, and family name, the server 
application allows the user to enter other information during the login dialog (for 
example, user job name, job class, account, project, and job execution ring). When all 
responses are entered, NAM/VE creates a LOGIN command to be included as the first 
command in the server job it submits to NOS/VE. Next, NAM/VE validates the user’s 
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Connection Request Validation 


identity based on the LOGIN command parameters, and the server job runs with the 
user’s identity. The user specified by the client application is billed directly for 
resources used by the server job, and the user must be validated for all server job 
activities. In addition, the user’s user prolog is executed in the server job. 


If NAM/VE detects errors in the LOGIN parameter list, it issues an error message and 
restarts the dialog. After three unsuccessful attempts, NAM/VE issues an error 
message and rejects the connection request. 


Connection Request Validation 


A server application validates a client application’s authority to connect to services 
provided by the server. However, for convenience, NAM/VE provides two optional forms 
of connection request validation: client validation and client address validation. The 
application developer can use either of these validation capabilities, or the developer | 
can write his or her own validation code within the program. In addition to using the 
NAM/VE validations, a programmer can write supplementary validation requirements. 


NAM/VE Client Validation 


When NAM/VE validates clients, NAM/VE accepts the client’s connection request on 
behalf of the server application. NAM/VE initiates an interactive dialog to obtain the 
client’s identity. 


The dialog is the same as the server job validation dialog. However, in client 
validation dialog, only the USER, PASSWORD, and FAMILY parameters are valid. All 
other parameters are ignored. 


Once the client’s identity is validated, NAM/VE checks the client’s entry in the 
NOS/VE validation file to verify that the client is authorized to access the requested 
server application. If the connection request is validated, NAM/VE assigns the 
connection to the server application, and the application begins processing. If the 
connection request is not validated, NAM/VE rejects the connection. 


NOTE 


For server job and client validation, the NOS/VE family validation file serves as the 
validation data base. The ADMINISTER_ VALIDATIONS utility is used to manage this 
data base. The NOS/VE validation file is maintained by the family administrator. For 
more information, see the NOS/VE User Validation manual listed in appendix B. 
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NAM/VE Client Address Validation 


NAM/VE can validate a connection request using the client application’s network 
address. When you define a server application, you can specify a list of network 
addresses authorized to connect to the server application with the the CLIENT_ 
ADDRESS server application attribute described in table 3-4. To validate a connection 
request, NAM/VE obtains the client application’s network address and verifies it 
against the list of authorized network addresses. If the client application is at a 
network address in the list, NAM/VE assigns the connection to the server application 
and the server application begins processing. If the client application is at a network 
address that is not in the list, NAM/VE rejects the connection and the server 
application receives no indication of the attempted connection. 


Network Directory 


A client application specifies a server application’s network address when initiating a 
connection request. However, you may choose to have a server’s network address vary 
with each activation of that server. To allow the client to locate the server, NAM/VE 
provides a network directory that maps one or more logical titles to the server's 
network address. The client need only specify a server’s title to obtain the appropriate 
network address. The following discussion explains how you can assign and create 
server titles and how the network performs directory searches. 


Assigning Server Titles 
Assigning titles to server applications serves two purposes: 


@ It allows the client to identify a server by a logical name that represents the 
service provided. 


e It eliminates any need for the client to know where a server application executes. A 
server may be moved from one network location to another without requiring 
clients to change the server’s identity. 


When two or more server applications register identical titles, NAM/VE assumes the 
applications provide identical services. Hence, when a client application translates a 
title, the network address returned may be the address of any server for which that 
title is registered. Therefore, the title you assign must uniquely identify the service 
provided. Neither the system nor the MANNA utility enforces this constraint. The 
network administrator must ensure that all server applications with the same title 
provide the same service. 


NOTE 


Before determining the network address of the server application, the CDCNET 
command CREATE_CONNECTION converts all letters in the specified server 
application title to uppercase. Only those characters allowed by SCL in name values 
are allowed. Therefore, when you assign a title to a server application that accepts 
connections from CDCNET terminals, specify the titles using only uppercase letters and 
other characters allowed in SCL names. 
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Title Management 


The MANAGE. NETWORK_APPLICATIONS utility allows you to manage server titles 
directly or to delegate title management to the server applications. In either case, you 
may create multiple titles for a server application. 


A title is a string of from one to 255 ASCII characters, including nongraphic 
characters. Uppercase and lowercase letters are significant. For eremple, the titles 
TIMESHARING and timesharing are not equivalent. 


You can directly specify titles by using the ADD_TITLE and DELETE_TITLE 
MANNA subcommands. Titles managed by the MANAGE_NETWORK._ APPLICATIONS 
utility remain in effect until you explicitly delete them. The MANNA utility also 
allows you to delegate title management responsibilities to a server application. A 
server application manages its titles by means of program interface requests to add and 
delete titles. You must specify the set of titles the server can manage by indicating 
one or more title patterns on the ADD_SERVER_MANAGED_ TITLE subcommand. 


A title pattern defines a set of titles by specifying a substring of characters common to 
each title in the set. For example, the title pattern: 


APP* 


is a title pattern that defines the set of all titles beginning with the characters APP. 
The asterisk (*) is a substitute (or wild card) character that matches any string of 
characters. Table 2-2 describes the various substitution characters available to create . 
title patterns. 


Table 2-2. Title Pattern Character Descriptions 
Character Description 


? Matches any single character of a title. 
. Matches any string of characters in a title, including the null string. 
C Matches the character enclosed in apostrophes. This character may be 


any character other than the apostrophe. 
Matches the apostrophe character in a title. 


[...] Matches any single character from a group of characters in a title. The 
group of characters is specified within the brackets, either as a list 
asic a range ({a-z]), or a combination ([a-zA-Z$#1-9]). The expression 

c’ may appear within the brackets to represent the character enclosed in 
apostrophes. Special characters (? * ’) do not have special meaning 
within the brackets. They represent themselves. 
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The following table lists some example title patterns. For each example pattern, the 
table gives examples of titles that can be matched and titles that cannot be matched. 


Title 
Pattern 


abc 


a?a 


az*az. 


q’*’* 


a”b 


al0123] 


ala-z*] 


ala-zA-Z]} 


NOTE 


Titles 
Matched 


abc 


aza 
ala 


azaz 
azlaz 
azXX Xaz. 


Titles 
Not Matched 


Abc 


aa 
abab 


az. 
azlz 
azXXXazY YY 


aBC 
a’”'Z 
ab 
a”b 


ab. 
a20 


aA 
a$. 


al 


Titles managed by a server application are implicitly deleted whenever the server 


application’s network address becomes inactive or a NOS/VE deadstart occurs. 


Title Registration in the Network Directory 
Titles that are registered in the directory are known throughout the network. 


NAM/VE registers server titles in the network directory as follows: 


@ For user-initiated server applications, NAM/VE registers the server’s titles in the 
directory when the first server job is initiated (using the command or procedure - 
defined by the application itself). The server’s titles are deleted when all instances 
of the server application terminate. 


e For NAM-initiated server applications, NAM/VE registers the server’s titles in the 
directory when the server application is activated (using the ACTIVATE_ SERVER 
subcommand). 
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Directory Searches 


When requesting a connection to the Timesharing application by using the CDCNET 
command CREATE_CONNECTION, you specify a title rather than a network address. 
For example: 


create_connection nosve002 


requests a connection to the application that is assigned the title NOSVE002. 


Directory Searches 


A client application obtains translations of titles registered in the directory by 
searching the directory. This search involves scanning the directory for titles that 
match a specified title pattern. A title translation for a title is delivered to the client 
application if it meets two criteria: 


@ The title matches the specified title pattern. 


@ The title was registered by a server application that used the same type of 
connection as the client application that requested the search. Connection type 
refers to the protocol used to provide a connection; the CDNA_SESSION protocol 
is used for host-to-host connections, and the CDNA_ VIRTUAL_TERMINAL 
protocol is used for CDCNET-connected terminals. For more information on the 
PROTOCOL attribute, see table 3-3. 


There are two types of directory searches: nonrecurrent and recurrent. A nonrecurrent 
search scans the directory only once. A recurrent search scans the directory 
continuously as long as the client application is active. 


Title translations for matching server titles that are subsequently registered in the 
directory are returned to the client application. The directory returns new server 
titles to the client application as long as the client remains active. This ensures that 
active client applications are informed of new servers in the network. 


To make a recurrent search possible, you broadcast the title translation to all remote 
systems when the title is first registered. You do this by using the BROADCAST_ 
REGISTRATION attribute described in table 3-4. 


Title Priority 


You can specify title priority to indicate a preferred server application among any 
number of applications that have the same title. Title priority is significant whenever a 
client application connection request specifies a title that is common to multiple server 
applications. If different priorities are assigned for the available server applications, the 
client is connected to the server with the highest priority. If two or more server 
applications have the same title with the same priority, the translations of the titles 
are delivered in random order. You use the TITLE_PRIORITY attribute (described in 
table 3-4) to specify title priority when you define a server application. 
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NOS/VE System-Defined Network Applications 


The system-defined NOS/VE network applications provide connections to CDCNET to 
support the following services: 


@ Timesharing 

@ Desktop Environment (Desktop/VE) 

@ Permanent File Transfer Facility/Queue File Transfer Facility (PTF/QTF) 
@ Batch Transfer Facility (BTF) 

@® Network Transfer Facility (NTF) 

@ File Transfer Protocol/VE (FTP/VE) 

@ Simple Mail Transfer Protocol/VE (SMTP/VE) 

@ Network File System/VE (NFS/VE) 


Timesharing 


The Timesharing network service provides interactive access to a NOS/VE system. 
(This service allows interactive terminals to log in to NOS/VE.) On dual-state systems, 
the Timesharing service is optional, since interactive terminals may also be connected 
through the dual-state partner system. The Timesharing service is provided by a single 
network application program. Figure 2-4 illustrates how the Timesharing service 
provides host-to-terminal connections in the CDCNET network. For more information 
about this network service, refer to the CDCNET Access Guide online manual 
(CDCNET_ACCESS). 


NOS/VE HOST 


T NAM/VE 


Interactive 
Terminal 


Figure 2-4. Timesharing Host-to-Terminal Connections 
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Desktop Environment (Desktop/VE) 


The Desktop Environment network service provides a secondary connection between a 
workstation and a NOS/VE system. The primary connection is the Timesharing service. 
The Desktop/VE service is provided by a single network application program. Each 
time the Desktop/VE service is started, a new instance of the Desktop/VE application is 
initiated within the user’s job. This secondary connection carries data defined by an 
internal Desktop/VE protocol. For more information about this network service, refer to 
the CDCNET Access Guide online manual (CDCNET_ ACCESS). 


Figure 2-5 shows how the Desktop/VE service provides the host-to-workstation 
secondary connections in the CDCNET network. 


NOS/VE HOST 


Job 1 Job 2 


Desktop/ Desktop/ 
VE VE 


Workstation 


Figure 2-5. Desktop/VE Host-to-Workstation Connections 
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Permanent File Transfer Facility/Queue File Transfer Facility 
(PTF/QTF) 


The Permanent File Transfer Facility/Queue File Transfer Facility (PTF/QTF) services 
allow files to be transferred between NOS/VE systems or between NOS/VE and NOS in 
a CDCNET network. The PTF/QTF services also allow file transfers between a NOS/VE 
system and an AOS/VS system. | 


The PTF service and the QTF service each provide two separate applications: a client 
application and a server application. The client/server relationship is described earlier 
in this chapter under Network Application Concepts. 


The PTF service allows the transfer of temporary and permanent files between 
NOS/VE systems or between NOS/VE and NOS or AOS/VS systems. The commands 
that initiate a file transfer are described in the NOS/VE System Usage manual. 


The QTF service gives you a means to transfer queued files (both jobs and listings) 
between NOS/VE systems or between NOS/VE and NOS or AOS/VS systems. The 
SUBMIT_JOB and PRINT_FILE commands are used to transfer jobs and print files. 
These commands are described in the NOS/VE System Usage manual. 


A site administrator can use the MANAGE_STORE_FORWARD_NETWORK utility 
to create a store-and-forward network file. This file is used to assist QTF in its 
store-and-forward function. See chapter 8 of this manual for details. 


Figure 2-6 shows PTF and QTF host-to-host connections. 


NOS/VE HOST 1 


NAM/VE 


NOS HOST 


Figure 2-6. PTF and QTF Host-to-Host Connections 
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Batch Transfer Facility (BTF) 


The Batch Transfer Facility (BTF) provides both input and output batch services. The 
BTF services include several client and server applications. Together, these applications 
give you batch device support to input jobs and print files in the CDCNET network. 
(Batch support for NOS/VE is provided only through CDCNET.) 
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Batch Transfer Facility (BTF) 


The BTF services consist of the following applications: 


Status and Control 
Facility Server/VE 
(SCFS/VE) 


Status and Control 
Facility/VE (SCF/VE) 


Status and Control 
Facility/DI (SCF/DI) 


Batch Transfer 
Facility/VE (BTF/VE) 


Batch Transfer Facility 
Server/DI (BTFS/DD 


OPERATE_STATION 
Utility (OPES) 


Batch Transfer Facility 
Server/VE (BTFS/VE) 


Batch Transfer 
Facility/DI (BTF/DI) 


Server application (called the I/O station control facility) 
that resides in the NOS/VE host computer. At least one 
SCFS/VE application must be present in each network. 
SCFS/VE communicates over connections with SCF/VE, 
SCF/DI, and OPES applications. It receives the status of 
batch output files and batch devices, schedules output files 
to batch devices, and routes I/O station control commands. 


Client application that resides in every NOS/VE mainframe 
in the network that supports batch output files. It informs 

SCFS/VE of available output files and processes file control 
commands from SCFS/VE. 


Client application that resides in every DI connected to 
batch devices. SCF/DI reports the status of batch devices to 
SCFS/VE and processes batch device contro! commands 
from SCFS/VE. 


Client application that resides in every host computer in 
the network that supports batch output files. It | 
communicates with BTFS/DI to transfer output files from 
the host to the batch devices. 


Server application that resides in every DI connected to 
batch output devices. It communicates with BTF/VE to 
transfer output files from the host to the batch devices. 


Client application that resides in the NOS/VE host 
computer and validates user permissions and accepts 
commands to control an I/O station. It maintains a 
connection to SCFS/VE over which commands are sent and 
command responses are received. A separate instance of the 
OPERATE_STATION utility application is initiated 
whenever the OPERATE_STATION command is executed. 
The OPERATE_STATION utility, its subcommands, and I/O 
station control for NOS/VE are described in the COCNET 
Batch Device User Guide. 


Server application that resides in all hosts that support 
batch input. It communicates with BTF/DI to transfer input 
files (jobs) from batch devices to the host. 


Client application that resides in all DIs connected to batch 
input devices. It communicates with BTFS/VE to transfer 
input files (jobs) from batch devices to the host. 


The relationships between the various BTF applications are shown in figure 2-7. 
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Network Transfer Facility (NTF) 


NOS/VE NOS/VE NOS/VE 
Client Server Client 
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Terminal 


Input 


Figure 2-7. BTF Application Services 


Device 


Network Transfer Facility (NTF) 


The Network Transfer Facility (NTF) service allows you to transfer queued files 
between a NOS/VE host and another host within the same network. The NTF service 
supports the IBM Network Job Entry (NJE) protocol and the HASP multileaving 
protocol for communication between hosts. 


The NTF service consists of the following applications: 


Batch Transfer Client application that resides in every host computer in 

Facility/VE (BTF/VE) the network that supports NTF. It communicates with 
BTFS/DI to transfer jobs and output files from the host to 
a remote system. 


Batch Transfer Facility Server application that resides in every host computer in 
Server/VE (BTFS/VE) the network that supports NTF. It communicates with 
. BTF/DI to receive input files and jobs from a remote 
system. 
Status and Control Server application (called the master I/O station control 
Facility Server/VE facility) that resides in the NOS/VE host computer. At least 
(SCFS/VE) one SCFS/VE application must be present in each network. 


SCFS/VE schedules jobs and output files to batch streams. 
It also receives control and status commands from both 
files and batch streams. 
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Network Transfer Client application that resides in every host computer in 

Facility/VE (NTF/VE) the network that supports NTF. NTF processes file 
control commands and informs SCFS/VE of jobs and 
output files available for transmission. 


Operate NTF (OPENTF) Client application in the host computer. OPENTF 
validates user permissions and establishes a connection 
with SCFS/VE for the operator. 


Batch Transfer Client application that transfers jobs and input files to 
Facility/DI (BTF/DI) BTFS/VE. BTF/DI processes file transfer commands for 
jobs and input files received from a remote system. 


Batch Transfer Facility Server application that receives output files from BTF/VE. 
Server/DI (BTFS/DI BTFS/DI processes file transfer commands for jobs and 
output files transmitted to a remote system. 


Status and Control Client application that processes batch stream 
Facility/DI (SCF/DI) configuration commands from the terminal definition 
procedure and also processes batch stream control 
commands received from SCFS/VE. SCF/DI reports the 
status of NTF remote systems and batch streams to 
SCFS/VE. 


The relationships between the various NTF applications are shown in figure 2-8. 


Server Client 


SCFS/VE 7 OPENTF /#- 
Client : | 
Terminal 


Operator 
Console 


Server Client Client NOSIVE 


BTFS/DI SCF/DI SCF/DI 


Client Server 


BTF/DI BTFS/VE 


Mainframe/ 


Remote . Terminal 

System DI 
Remote 
System 


Figure 2-8. NTF Application Services | 


Mainframe/Terminal 
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File Transfer Protocol/VE (FTP/VE) 


The File Transfer Protocol/VE (FTP/VE) implements the File Transfer Protocol (FTP) of 
the set of protocols provided by the Transmission Control Protocol/Internet Protocol 
(TCP/IP). FTP/VE provides file transfer capabilities to and from connected TCP/IP 
hosts. Both the FTP client and FTP server protocols are supported. The FTP client 
application must be running in the local host and its associated FTP server application 
must be running in the remote host. 


NOTE 


Both the client application (FTP) and its associated server application (FTPS) are 
defined as client applications. See appendix C for more information about defining the 
File Transfer Protocol applications. 


For detailed information on FTP/VE, see the TCP/IP Usage manual. 
The relationship between the FTP client and server applications is shown in figure 


2-9. 


Local Host Remote Host 


Terminal! 


User | ~~" STORAGE 


Figure 2-9. FTP Application Services 


Simple Mail Transfer Protocol/VE (SMTP/VE) 


The Simple Mail Transfer Protocol/VE (SMTP/VE) implements the Simple Mail 

: Transfer Protocol (SMTP) of the set of protocols provided by the Transmission Control 
® .Protocol/Internet Protocol (TCP/IP). SMTP/VE provides mail transfer capabilities 
including mail relay to and from connected TCP/IP hosts. Both the SMTP client. and 
SMTP server protocols are supported. A NOS/VE mail application can communicate 
with SMTP/VE through the NOS/VE batch mail queue to send and receive mail 
messages. A command interface is also provided to allow site-written mail applications 
to directly access SMTP/VE mail services. . 


NOTE 


Both the client application (SMTP) .and its associated server application (SMTPS) are 
defined as client applications. See appendix C for more information about defining the 
Simple Mail Transfer Protocol applications. 
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Network File System/VE (NFS/VE) 


For detailed information about SMTP/VE, see the TCP/IP Usage manual. 


The relationship between the SMTP/VE client, server, mail queue, and command 
interface and the local (user-written) mail application is shown in figure 2-10. 


CYBER NOS/VE Remote Host 


Terminal 
SMTPS User 


Terminal 
User 


Local SMTP 
Mall Command 
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Mass Storage 
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Figure 2-10. SMTP/VE Services 


Network File System/VE (NFS/VE) 


The Network File System on NOS/VE (NFS/VE) provides file server support for the 
NFS 3.2 protocol developed by Sun Microsystems, Inc. + This support allows any 
NOS/VE system to act as a file server for client systems with the NFS 3.2 client 
functions installed. 


The NFS/VE server is made up of the following Interprocess Communication (IPC) 
applications: 


@ NFS/VE, which contains the bulk of Control Data’s implementation of the Network 
File System. 


e Portmapper, which maps calls from client systems into registered server calls. 
@ PCNFSD, which allows PCs running PC-NFS? to be validated to use NFS/VE. 


These applications reside on the server system; that is, on the CYBER host running 
NOS/VE. These applications interface with Sun Microsystems’ NFS protocols, Remote 
Procedure Call (RPC) and External Data Representation (XDR), on the CYBER. These 
server-based protocols then interface with the RPC and XDR protocols on the client 
system. 


1. Sun Microsystems is a registered trademark and NFS is a trademark of Sun Microsystems, Inc. 
2. PC-NFS is a product and trademark of Sun Microsystems, Inc. 
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NOTE 


These Interprocess Communication applications are defined as a single client 
application. See appendix C for more information about defining the IPC applications. 


For detailed information about NFS/VE, see the TCP/IP Usage manual. 
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Using the MANAGE_NETWORK_ 
APPLICATIONS Utility 3 


Introduction 


This chapter shows how you can use the MANAGE_NETWORK_ APPLICATIONS 
(MANNA) utility to manage network applications. The following topics are discussed: 


@ Relationship between the MANNA utility and network application definitions. 
@ Using MANNA to define, redefine, or change application definitions. 

@ Using MANNA to display application status and attributes. 

@ Updating the application definitions file. 

e@ Attribute descriptions for client and server applications. 


A network application definition is a set of attributes that defines the characteristics of 
a network application. These application definitions identify the network application 
programs authorized to execute on a NOS/VE system. The MANNA utility creates and 
maintains the application definitions on the 
$SYSTEM.NETWORK.APPLICATION.DEFINITIONS file. 


The MANNA utility consists of MANNA subcommands and four subutilities that 
together allow you to define, redefine, and change network application definitions. See 
figure 3-1 for a hierarchical listing of the MANNA subcommands and subutilities. 
Complete formats of the MANNA utility command and each subutility subcommand are 
given in chapter 4. 
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Introduction 


MANAGE_NETWORK_APPLICATION 


(MANNA) Utility 


ACTIVATE_CLIENT 
ACTIVATE_SERVER 

CHANGE _CLIENT 
CHANGE_SERVER 
DEACTIVATE_CLIENT 
DEACTIVATE_SERVER 
DEFINE_CLIENT 
DEFINE_SERVER 
DELETE_CLIENT 
DELETE_SERVER 
DISPLAY_APPLICATION_STATUS 
DISPLAY_CLIENT_ATTRIBUTE 
DISPLAY_CLIENT_STATUS 
DISPLAY_SERVER_ATTRIBUTE 
DISPLAY_SERVER_STATUS 
GENERATE_APPLICATION_DEFINITION 
GENERATE_CLIENT_DEFINITION 
GENERATE_SERVER_DEFINITION 


QUIT 
DEFINE_CLIENT DEFINE_SERVER 
and and 
CHANGE_CLIENT CHANGE_SERVER 
Subutilities ; Subutilities 


CHANGE_APPLICATION_IDENTIFIER 
CHANGE_CLIENT_VALIDATION 

CHANGE _CONNECTION_PRIORITY ; 
CHANGE_MAXIMUM_CONNECTIONS 


ADD_CLIENT_ADDRESS 
ADD_SERVER_MANAGED_TITLE 
ADD_TITLE 

CHANGE _ACCEPT_CONNECTION 
CHANGE_APPLICATION_IDENTIFIER 
CHANGE_CLIENT_VALIDATION 
CHANGE_CONNECTION_PRIORITY 
CHANGE _MAXIMUM_CONNECTIONS 
CHANGE_SERVER_JOB 
CHANGE_SERVER_VALIDATION 
DELETE_CLIENT_ADDRESS 
DELETE_SERVER_MANAGED_TITLE 
DELETE_TITLE 
DISPLAY_SERVER_ATTRIBUTES 
END_CHANGE_SERVER(CHAS only) 
END_DEFINE_SERVER(DEFS only) 
GENERATE_SERVER_DEFINITION 


DISPLAY_CLIENT_ATTRIBUTES 
END_CHANGE_CLIENT(CHAC only) 
END_DEFINE_CLIENT(DEFC only) 
GENERATE_CLIENT_DEFINITION 


Figure 3-1. Manage Network Application Utility Hierarchy 


The DEFINE_CLIENT and DEFINE_SERVER subutilities are used to change the 
initial values of client and server attributes. (The initial value of an attribute is a 
default value established by a define subutility.) The CHANGE_CLIENT and 
CHANGE_SERVER subutilities are used to change the previously defined attribute 
values. 
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Therefore, with the MANNA utility, you have the means to define new network 
applications or modify existing definitions, redefine or modify system-defined default 
values for application definitions, and define or modify user-defined application 
definitions. 


Two methods are available to change an application’s definition. You should use the 
method that is most appropriate for your purposes: 


© Use the GENERATE_CLIENT_DEFINITION, GENERATE_SERVER_ 
DEFINITION, or GENERATE_APPLICATION_ DEFINITION MANNA 
subcommands to generate (on a new file) the subcommands that represent the 
current definition of the application on a file. After you edit this file, you can 
modify these subcommands to redefine the application. 


® Use the MANNA CHANGE_CLIENT or CHANGE_SERVER subutilities to 
change only specific attribute values. 


Prerequisites for Using MANNA 


To use the MANNA utility, your validation must include the NETWORK_ 
APPLICATION. MANAGEMENT capability. You are validated by the system 
administrator. See the NOS/VE User Validation manual for more information. 


Restrictions on Using Subcommands 


There are some restrictions on the use of various subcommands within the MANNA 
utility. The following restrictions apply: 


@® Subcommands that set application attributes can be entered only within the 
DEFINE_SERVER, CHANGE_SERVER, DEFINE_CLIENT, or CHANGE_ 
CLIENT subutility. 


@ Subcommands that activate and- deactivate applications and/or that delete 
application definitions can be entered only outside the subutilities. 


Subcommands for displaying application attributes and status are not restricted. You 
can use them either inside or outside of the subutilities. 


Whenever the client or server subutilities are used, the MANNA utility accesses the 
application definition file in exclusive access mode and enforces SCL 
restricted-command mode. 
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Defining an Application 


Use the following sequence of steps to define a new application. Before defining a new 
application, you may wish to review the client and server application attributes in 
tables 3-1 and 3-2 or the MANNA subcommands in chapter 4 to determine the values 
you want to use for the attributes. 


‘1. Start the MANNA utility with the MANAGE_NETWORK_APPLICATION 
command. After you call the utility, you receive this prompt: 


mna/ 
2.. Start the subutility for the type of application you want to define: 


© To define a client application, start the client subutility with the DEFINE_ 
CLIENT subcommand. Include the name of the application you are defining 
and the protocol the application uses. (To determine what protocol you should 
specify, see the Protocol attribute descriptions in table 3-3.) Once you call the 
client subutility, you receive this prompt: 


defc/ 


@ To define a server application, start the server subutility with the DEFINE_ 
SERVER subcommand. Include the name of the application you are defining, 
the protocol the application uses, and how the application is initiated. Once 
you call the server subutility, you receive this prompt: 


defs/ 


3. If necessary, use the subcommands of the server or client subutility to change the 
initial values of the attributes as defined by the subutility. The attributes, their 
initial values, and the subcommands you use to change them are listed in table 
3-1 (for client applications) and table 3-2 (for server applications). At any time in 
this process, you can use the DISPLAY_SERVER_ATTRIBUTE or DISPLAY_ 
CLIENT_ATTRIBUTE subcommand to examine the current attribute values. 


-4, When you finish changing the values for the application attributes, save the 
definition by ending the subutility session: 


e To end the client subutility, enter the END_DEFINE_CLIENT subcommand. 


® To end the server subutility, enter the END_DEFINE_SERVER subcommand. 


The MANNA utility checks any definition that is to be saved. If the utility finds 
errors in the definition, it does not end the subutility session. Instead, it issues 
messages explaining the problem and gives you the opportunity to correct it. 


5. If neccessary, you can discard the definition you created during the session by 
entering the SAVE_ DEFINITION parameter and specifying the value FALSE. The 
following subcommands discard the client or server definition just created: 


defc/end_define_client save_definition=false 


defs/end_define_server save_definition=false 
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6. After you end the subutility, you again receive the MANNA utility prompt. You 
should now activate the application with either the ACTIVATE_CLIENT or 
ACTIVATE_SERVER subcommand. Include the parameter that specifies the name of 
the application to be activated. 


7. Exit the MANNA utility with the QUIT subcommand. 


Changing an Application 


Use the following sequence of steps to change specific attribute values of an existing 
application definition. Before changing an application definition, you may wish to 
review the client and server application attributes in tables 3-1 and 3-2 or the 
MANNA subcommands in chapter 4 to determine the values you want to use for the 
attributes. 


1. Start the MANNA utility with the MANAGE_NETWORK_ APPLICATION 
command. After you call the utility, you receive this prompt: 


mna/ 
2. Start the subutility for the type of application you want to change: 


© To change a client application, start the client subutility with the CHANGE_ 
CLIENT subcommand and specify the name of the application you are changing. 
Once you call the client subutility, you receive this prompt: 


chac/ 


@ To change a server application, start the server subutility with the CHANGE_ 
SERVER subcommand and specify the name of the application you are changing. 
Once you call the server subutility, you receive this prompt: 


chas/ 


3. Use the subcommands of the server or client subutility to change the values of the 
attributes. The attributes and the subcommands you use to change them are listed 
in table 3-1 (for client applications) and table 3-2 (for server applications). At any 
time in this process, you can use the DISPLAY_SERVER_ATTRIBUTE or 
DISPLAY_CLIENT_ATTRIBUTE subcommand to examine the current attribute 
values. 


4. When you finish changing the values for the application attributes, save the 
definition by ending the subutility session: 


© To end the client subutility, enter the END_CHANGE_CLIENT subcommand. 


® To end the server subutility, enter the END_CHANGE_SERVER subcommand. 


The MANNA utility checks any definition that is to be saved. If the utility finds 
errors in the definition, it does not end the subutility session. Instead, the 
attributes are restored to their values before any changes were entered, and the 
utility issues messages explaining the problem ous gives you the opportunity to 
correct it. 
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5. If necessary, you can discard the definition you created during the session by 
entering the SAVE_ DEFINITION parameter and specifying the value FALSE. The 
following subcommands discard the client or server definition just created: 

chac/end_change_client save_definition=false 
chas/end_change_server save_definition=false 

6. After you end the subutility, you again receive the MANNA utility prompt. The 
changes made to the application definition take effect immediately for all new 
connections to the application. Existing connections are unaffected. 

7. Exit the MANNA utility with the QUIT subcommand. 

NOTE 


You must be careful when changing any of the attributes for the system-defined | 
NOS/VE applications. If you change some of the defined attributes, the application may 
function improperly or not at all. For example: If you change the ACCEPT_ . 
CONNECTION attribute to a value of TRUE for the SCFS/VE application or the PTF 


application, the application will not function. However, if you change other attributes, 


the application’s behavior may not be altered, and you can then modify the application 
to meet your needs (for example, to add a title to the PIF server application). 


Redefining an Application 


Use the following sequence of steps to generate a.copy of an existing application 
definition, edit this copy to redefine the application definition, and replace the original 
application definition with the edited copy. Before redefining an application, you may 
wish to review the client and server application attributes in tables 3-1 and 3-2 or the 
MANNA subcommands in chapter 4 to determine the values you want to use for the 
attributes. 


Le 


Start the MANNA utility with the MANAGE_NETWORK_§APPLICATION- 
command. After you call the utility, you receive the prompt: 


mna/ 


Obtain a copy of the application you wish to redefine using the GENERATE 
SERVER_DEFINITION, the GENERATE_CLIENT_DEFINITION, or the 
GENERATE_APPLICATION_DEFINITION subcommand. Use the OUTPUT 
parameter to name an output file for the generated definition. 


Enter the EDIT_FILE command to edit the output file and change the definition. 
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4, Deactivate the original application with the DEACTIVATE_SERVER or 
DEACTIVATE_CLIENT subcommand. The TERMINATE_ACTIVE_CONNECTIONS 
parameter on this subcommand allows you to deactivate the application immediately 
or let currently active connections end normally. 


@ If you specify a value of FALSE, active connections are allowed to continue, but 
no new users are allowed to access the application. Use either the DISPLAY_ 
CLIENT_STATUS or DISPLAY_SERVER_STATUS subcommand to check for 
active connections. Then, when all users are disconnected, the MANNA utility 
deactivates the application. 


e If you specify a value of TRUE, all connections to the application are terminated 
and the application is deactivated immediately. 


5. Delete the original application definition with the DELETE_ SERVER or DELETE_ 
CLIENT subcommand. 


6. Insert the output file containing the entire edited definition into the command 
stream using the INCLUDE_FILE command. 


7. Reactivate the redefined application with the ACTIVATE_ SERVER or ACTIVATE_ 
CLIENT subcommand. 


8. Exit the MANNA utility with the QUIT subcommand. 
For example, to redefine the server application VE105, you enter: 


manage_network_appl ication 
mna/generate_server_definition server=ve1l05 output =def 
mna/edit_file file=def 


. (make the appropriate changes to the definition) 


mna/deactivate_server server=ve105 terminate_act ive_connect ions=true 
mna/delete_server server=ve105 

mna/include_file file=def 

mna/activate_server server=ve105 

mna/quit 

/ 
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Displaying Application Status | 
- Several MANNA subcommands allow you to display the status of network applications. 


® To display the status of one or more applications use the DISPLAY_ 
- APPLICATION_STATUS subcommand. For example: 


mna/display_application_status application=nve | 
‘displays status for the application named NVE on file $OUTPUT. The subcommand: 
mna/display_application_status application=all 
displays status information for all of the current applications in the system. To 
write the information to a file other than $OUTPUT, specify a file name on the 
OUTPUT parameter: 
mna/display_application_status application=all output=$user .save_all 
® To display status for only server applications or only client applications, you can 
-use either the DISPLAY_SERVER_STATUS or DISPLAY_CLIENT_STATUS 
subcommand. You can specify either the name of one or more applications to be 
displayed or the keyword ALL. For example: 
mna/display_server_status server=ve105 
- (status display for server application ve105) 


mna/display_client_status client=all 


. (status display for all client applications) 
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Displaying Application Attribute Values 


To display the current attribute values for a server or client application, you can use 
either the DISPLAY_SERVER_ATTRIBUTE or DISPLAY_CLIENT_ATTRIBUTE 
subcommand. You can enter one or more application names or the keyword ALL. Also, 
you can specify whether to display certain attributes or all attributes. For example: 


mna/display_server_attribute server=ve105 attribute=protocol 
. (attribute display of the protocol! for server application VE105) 
mna/display_client_attribute client=ve020 attr ibutes=al 
. (attribute display of all attributes for client application VE020) 
The attribute display subcommands can be entered both inside and outside the 
subutilities. If you enter a display subcommand outside a subutility and do not specify 
the applications to be displayed, the attributes for all defined applications are 
displayed. If you enter a display subcommand inside a subutility and don’t specify the 


applications to be displayed, the attributes for the application currently being defined 
in the subutility are displayed. For example: 


mna/display_server_attribute 
. (attribute display of all attributes of all applications) 


mna/define_server server=ve100 protocol=cdna_session 
defs/display_server_attribute 


. (attribute display of all attributes for application VE100) 
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Updating the Application Definitions File 


The MANNA utility performs the following functions whenever you update the 
application definitions file: 


@ When you call a define or a change subutility, it attaches the highest cycle of the 
application definitions file for exclusive access. This prevents concurrent updates. 


e The utility checks to see if cycle 1 of the application definitions file already exists. 
(During the update process, MANNA uses cycle 1 as a temporary definitions file.) If 
cycle 1 is found, the utility assumes that an update was attempted and failed. 
Therefore, the utility issues a message to the job log indicating that a previous 
update attempt has failed, and deletes cycle 1. 


@ Your changes to the application definitions are made on a working copy of the 
definitions file within the utility session. 


@ The modified definitions file is rewritten as cycle 1 of the file. 
@ The retention period of the previous cycle of the file is changed to two days. 


@ The utility changes cycle 1 to be the oer cycle of the file, then this cycle of the 
file is returned. 


This updating process ensures that the highest cycle of the application definitions file 
is valid, and (using the cycle number) it provides a convenient way to identify the 
latest version of the file on permanent file backup tapes. 


The utility does not delete older versions (cycles) of the application definitions file. 
Each site is responsible for deleting unneeded cycles to conserve file space. 


3-10 Network Management Revision C 


Application Attributes 


Application Attributes 


Client and server applications have separate sets of attributes. Table 3-1 lists client 
application attributes, their initial values (which are set by the DEFINE_CLIENT 
subutility), and the subcommands you can use to change their values. Table 3-2 lists 
the same information for a server application. Tables 3-3 and 3-4 give you an expanded 


description of each attribute. 


Table 3-1. Client Application Attributes Overview 


Initial 
Attribute Value 
Application identifier VARIABLE 
Client capability NONE 
Client ring 13 
Client system privilege FALSE 
Connection priority 0 
Maximum connections 65,535 
Protocol None! 


1. You must specify a protocol. 


Subcommand 


CHANGE_APPLICATION_ 
IDENTIFIER 


CHANGE_CLIENT_ VALIDATION 
CHANGE_CLIENT_ VALIDATION 
CHANGE_CLIENT_ VALIDATION 
CHANGE_CONN ECTION _PRIORITY 
CHANGE_MAXIMUM_CONNECTIONS 
DEFINE_CLIENT 
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Table 3-2. Server Application Attributes Overview 


Attribute 


Accept connection 


Application identifier 


Broadcast registration 


Client address 


Client information source 


Client validation 
Connection priority 
Maximum connections 
NAMN-initiated 
Protocol 

Server capability 
Server job 


Server job maximum 
connections 


Server job validation source 


Server managed titles 


Server ring 

Server system privilege 
Title 

Title data 


Title priority 


Initial 
Value 


TRUE 
VARIABLE 


FALSE 


No list 


DIALOG 
NONE 

0. 

65,535 
TRUE 
None! 
NONE 

A null file 
65,535 


SERVER 


No list 


13 
FALSE 
No list 
No string 
1 


Subcommand 


CHANGE..ACCEPT_CONNECTION 


CHANGE_APPLICATION_ 
IDENTIFIER 


' ADD_TITLE 


ADD_CLIENT_ADDRESS and 
DELETE_CLIENT_ADDRESS 


None (this attribute cannot be changed) 
CHANGE. CLIENT_ VALIDATION 
CHANGE_CONNECTION _ PRIORITY 
CHANGE_MAXIMUM_CONNECTIONS 
DEFINE_SERVER 

DEFINE_SERVER 
CHANGE_SERVER_ VALIDATION 
CHANGE_SERVER_JOB 
CHANGE_SERVER_JOB 


CHANGE_SERVER_JOB 


ADD_SERVER_MANAGED-_TITLE 
and DELETE_SERVER_MANAGED_ 
TITLE 


CHANGE_SERVER_ VALIDATION 
CHANGE_SERVER_ VALIDATION 
ADD_TITLE and DELETE_TITLE 
ADD_TITLE 
ADD_TITLE 


: 1. You must specify a protocol. 
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Table 3-3. Client Application Attribute Descriptions 


Attribute 


Application 
Identifier 


Client Capability 


Client Ring 


Revision C 


Description 


Indicates the identifier to be used in the application’s network 
address. You can choose a specific number in the range from 2000 
to 3000 to be used for the identifier, or specify the keyword 
VARIABLE. VARIABLE causes an identifier to be assigned from a 
pool of identifiers each time the application is initiated. 


The initial value is VARIABLE. You can specify this attribute 
with the CHANGE_APPLICATION_IDENTIFIER subcommand. 


Indicates the NOS/VE capability (ability to access special system 
features or utilities) that the user must have in order to call 
NAM/VE interfaces that perform client application functions. You 
may set this attribute’s value to name one of the following 
capabilities: 


@ EXPLICIT_REMOTE_FILE 

e IMPLICIT_REMOTE_FILE 

© HPA_VE_INITIATOR 

@ NETWORK_APPLICATION_ MANAGEMENT 
© NETWORK_OPERATION _ 

© NTF_OPERATION 

© STATION_OPERATION 

° TIMESHARING 

@ Site-defined capability 


The capability you specify on this attribute must be present in the 
validation file entry for the user in whose job the client 
application executes. The family administrator is responsible for 
assigning this capability to the user in the NOS/VE validation file. 
For more information about these capabilities, see the NOS/VE 
User Validation manual listed in appendix B. 


The initial value is NONE (no capability is required). You can . 
specify this attribute with the CHANGE_CLIENT_ VALIDATION 
subcommand. 


Indicates the highest ring from which a client application may call 
certain NAM/VE interfaces that perform client application 
functions. 


The initial value is 13 (the interfaces can be called from any ring 
up to ring 13). You can specify this attribute with the CHANGE_ 
CLIENT_ VALIDATION subcommand. 


(Continued) 
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Table 3-3. Client Application Attribute Descriptions (Continued) 


Attribute . Description 
Client System Indicates whether a client application must be system-privileged to 
Privilege call NAM/VE program interfaces that perform client application 


functions. (System-privileged code is code that is either in a 
system job or executes at ring 3 or lower.) 


The initial value is FALSE (the affected NAM/VE interfaces can 
be called from any user code). You can specify this attribute with 
the CHANGE_CLIENT_VALIDATION subcommand. 


NOTE 
This attribute is not operational for this release of NOS/VE. 


Connection Specifies the priority associated with the data sent by the client 
Priority application over a network connection. Each client application can 
| specify the priority of the data it sends. Client and server 
applications need not assign the same priority to the connection 
between them. 


The initial value is 0, which is the lowest priority. You can 
specify this attribute with the CHANGE_CONNECTION_ 
PRIORITY subcommand. 


Maximum Indicates the maximum number of concurrent connections that can 
Connections be established by all instances of a client application. 


The initial value is 65,535. You can specify this attribute with the 
CHANGE_MAXIMUM_CONNECTIONS subcommand. 


Protocol Indicates the type of connection that is established by the 
application. Connection types are identified by the protocol that is 
used to provide a connection. An application can use only one type 
of connection. 


CDNA_SESSION protocol (used for host-to-host connections) and 
CDNA_VIRTUAL_TERMINAL protocol (used for CDCNET 
-connected terminals) are currently supported. (For more 
information on CDCNET protocols, refer to COCNET System 
Programmer’s Reference, Volume 3.) 


There is no initial value set by the system. You must specify this 
attribute with the DEFINE_CLIENT subcommand. 
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Table 3-4. Server Application Attribute Descriptions 


Attribute 


Accept Connection 


Application 
Identifier 


Broadcast 
Registration 


Client Address 


Revision C 


Description 


Indicates whether NAM/VE should accept connection requests on 
behalf of the server application. If NAM/VE accepts connections, 
the server application need not explicitly accept a connection after 
acquiring it. 


NAM/VE must accept a requested connection if a dialog with the 
client is necessary. Therefore, if validation information is required 
from the client, and the CLIENT_INFORMATION_SOURCE 
attribute specifies that the information came from a dialog, the 
accept connection attribute must be TRUE. (See also the CLIENT_ 
VALIDATION attribute and the SERVER_JOB_ VALIDATION_ 
SOURCE attribute.) 


The initial value is TRUE. You can specify this attribute with the 
CHANGE_ACCEPT_CONNECTION subcommand. 


Indicates the identifier to be used in the application’s network 
address. You can choose a specific number in the range from 2000 
to 3000 to be used for the identifier, or specify the keyword 
VARIABLE. VARIABLE causes an identifier to be assigned from a 
pool of identifiers each time the application is initiated. 


The initial value is VARIABLE. You can specify this attribute 
with the CHANGE_APPLICATION_IDENTIFIER subcommand. 


Indicates whether a title translation should be distributed to a 
remote system whenever the title is registered in the network 
directory. Titles should be distributed when a client application 
uses a recurrent directory search in order to learn of new servers 
on the network. 


The initial value is FALSE (titles are not distributed). You can 
specify this attribute with the ADD_TITLE subcommand. 


Indicates the network addresses from which a client application 
may connect to a server. If a client application resides at one of 
the addresses in this list, NAM/VE assumes that it is authorized 
to request a connection to the server application. If no addresses 
are specified, clients at any address are authorized to connect to 
the server. 


The initial value is no list of network addresses. You can add 
client addresses with the ADD_CLIENT_ADDRESS subcommand 
and delete them with the DELETE_CLIENT_ADDRESS 


subcommand. 
(Continued) 
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Table 3-4. Server Application Attribute Descriptions (Continued) 
Attribute Description 


Client Information Indicates how validation information should be obtained from a 

Source client application, if necessary. (This information could be required 
for client validation and/or server job validation.) The value 
DIALOG indicates that client information is obtained via a dialog 
using the connection from the client. 


The initial value is DIALOG. This attribute cannot be changed. 


Client Validation Indicates the NOS/VE capability (ability to access special system 
features or utilities) that the client must have to access the 
server. If you want the server application to require validation 
from the client, you may set this attribute’s value to name one of 
the following capabilities: 


e EXPLICIT_REMOTE_FILE 

@ IMPLICIT_REMOTE_FILE 

e HPA_VE_INITIATOR 

@ NETWORK_APPLICATION. MANAGEMENT 
@ NETWORK. OPERATION 

e@ NTF_OPERATION 

e STATION_OPERATION 

e TIMESHARING 

® Sjite-defined capability 


The capability you specify on this attribute must be present in the 
client’s validation file entry. The family administrator is 
responsible for assigning this capability to the client in the 
NOS/VE validation file. For more information about these 
capabilities, see the NOS/VE User Validation manual listed in 
appendix B. 


The initial value is NONE. You can specify this attribute on the 
CHANGE_CLIENT_ VALIDATION subcommand. 


Connection Specifies the priority associated with the data sent by the server 

Priority application over a network connection. Each server application can 
specify the priority of the data it sends. Client and server 
applications need not assign the same priority to the connection 
between them. 


The initial value is 0, which is the lowest priority. You can 
specify this attribute with the CHANGE_CONNECTION_ 
PRIORITY subcommand. 


(Continued) 
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Table 3-4. Server Application Attribute Descriptions (Continued) 


Attribute 


Maximum 
Connections 


NAM-Initiated 


Protocol 


_ Server Capability 
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Description 


Indicates the maximum number of concurrent connections that can 
be established by all instances of a server application. This value 
is the total number of connections active for the application. Do 
not confuse it with the maximum number of concurrent 
connections for a single instance of an application, which is set by 
the SERVER_JOB_MAXIMUM_CONNECTIONS attribute. 


The initial value is 65,535. You can specify this attribute with the 
CHANGE_MAXIMUM_CONNECTIONS subcommand. 


Indicates whether NAM/VE initiates a server application job. 


The initial value is TRUE. You can specify this attribute with the 
DEFINE_SERVER subcommand. 


Indicates the type of connection that is established by the 
application. Connection types are identified by the protocol that is 
used to provide a connection. An application can use only one type 
of connection. 


CDNA_SESSION protocol (used for host-to-host connections) and 
CDNA_VIRTUAL_TERMINAL protocol (used for CDCNET 
-connected terminals) are currently supported. For more 
information on CDCNET protocols, refer to CDCNET System 
Programmer’s Reference, Volume ‘3. 


There is no initial value set by the system. You must specify this 
attribute with the DEFINE_SERVER subcommand. 


Indicates the NOS/VE capability required to call NAM/VE program 
interfaces that perform server application functions. You may set 
this attribute’s value to one of the following capabilities: 

@ EXPLICIT_REMOTE_FILE 

@® IMPLICIT_REMOTE_ FILE 

e HPA_VE_INITIATOR 

e NETWORK_ APPLICATION. MANAGEMENT 

@ NETWORK _ OPERATION 

®@ NTF_OPERATION 

e@ STATION_OPERATION 

@ TIMESHARING 


@ Site-defined capability 
(Continued) 
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Table 3-4. Server Application Attribute Descriptions (Continued) 


Attribute 


Server Job 


Server Job 
Maximum 
Connections 


Server Job — 
Validation Source 


Server Managed 
Titles 


Description 


The capability you specify on this attribute must also be present 
in a validation file entry for the user in whose job the server 
application executes. The family administrator is responsible for 
assigning this capability to the user in the NOS/VE validation file. 
For more information about these capabilities, see the NOS/VE 
User Validation manual listed in appendix B. 


The initial value is NONE (no capability is required). You can 
specify this attribute with the CHANGE_SERVER_ VALIDATION 
subcommand. 


Specifies a file that contains the sequence of SCL commands that 
perform the function of a NAM-initiated server application (that 
is, the sequence of commands executes an instance of the server 
application). The sequence of commands can contain any 
system-defined or user-defined commands. 


The initial value is a null file (no list of SCL commands). You can 
specify this attribute with the CHANGE_SERVER_JOB 
subcommand. 


Indicates the maximum number of concurrent connections that a 
NAM-initiated server application job can support. This value is the 
number of concurrent connections that a single instance of an 
application can have. Do not confuse it with the total number of 
connections active for all instances of an application (this latter 
number is set by the MAXIMUM_CONNECTIONS attribute). 


The initial value is 65,535. You can specify this attribute with the 
CHANGE_SERVER_JOB subcommand. 


Indicates the validation information source for a NAM-initiated 
server job. If you specify SERVER, the first command in the 
server job must be a LOGIN command that supplies the necessary 
information. If you specify CLIENT, validation information is 
obtained from the client, and the server job cannot contain a 
LOGIN command. 


. The initial value is SERVER. You can specify this attribute with 


the CHANGE_SERVER_JOB subcommand. 


Specifies a list of title patterns that defines the set of server titles 
that can be managed by the server application itself via NAM/VE 
program interfaces. These interfaces allow the server application to 
add or delete titles to the list of titles registered in the network 
directory for the server. A title managed via the interfaces must 
match a title pattern in the list defined by this attribute. 


The initial value is no list of title patterns. You can add title 
patterns with the ADD_SERVER_MANAGED_ TITLE 
subcommand or delete title patterns with the DELETE_SERVER_ 
MANAGED_ TITLE subcommand. 


(Continued) 
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Table 3-4. Server Application Attribute Descriptions (Continued) 


Attribute Description 
Server Ring Indicates the highest ring from which a server application may 
call certain NAM/VE interfaces that perform server application 
functions. : 


The initial value is 13 (the interfaces can be called from any ring 
up to ring 13). You can specify this attribute with the CHANGE_ 
SERVER_ VALIDATION subcommand. 


Server System Indicates whether a server application must be system-privileged 

Privilege to call NAM/VE interfaces that perform server application 
functions. (System-privileged code is code that is either in a 
system job or executes at ring 3 or lower.) 


The initial value is FALSE (the affected NAM/VE interfaces can 
be called from any user code). You can specify this attribute with 
the CHANGE_SERVER_ VALIDATION subcommand. 


NOTE 
This attribute is not operational for this release of NOS/VE. 


Title Indicates the title or titles to be registered in the network 
directory for a server application. 


The initial value is no list of titles. You can add titles with the 
ADD_TITLE subcommand and delete titles with the DELETE_ 
TITLE subcommand. 


Title Data Indicates the string of data to be delivered to a client application 
with the translation of a title. This string can have up to 32 
characters. 


The initial value is no string of data. You can specify this 
attribute with the ADD_TITLE subcommand. 


Title Priority Indicates the priority of the server application whose title is 
registered in the network directory relative to other servers that 
register the same title. 


The initial value is 1 (maximum priority). You can specify a 
number in the range from 1 to 255. You can specify this attribute 
with the ADD_TITLE subcommand. 
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MANAGE_NETWORK_APPLICATIONS 
Command and Subcommands 4 


MANNA Utility 


The MANAGE_NETWORK_APPLICATIONS (MANNA) utility is an SCL command 
utility. It follows the rules for utilities given in the NOS/VE System Usage manual. 


Except for QUIT, all of the utility subcommands have an optional STATUS 
parameter. Information on using the STATUS parameter can be found in the NOS/VE 
System Usage manual. 


You must be validated by the system administrator to use the MANNA utility. For 
more information, refer to the NOS/VE User Validation manual. 


Certain MANNA subcommands that define or change applications operate as 
subutilities of the MANNA utility. These subutililies are: DEFINE_CLIENT, 
DEFINE_SERVER, CHANGE_CLIENT, and CHANGE_SERVER. These subutilities 
allow you to change and undo variations to an application definition. To initiate one 
of these subutilities, use the associated MANNA subcommand: DEFINE_CLIENT 
(DEFC), DEFINE_SERVER (DEFS), CHANGE_CLIENT (CHAC), or CHANGE_ 
SERVER (CHAS). 
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MANAGE_NETWORK_APPLICATION 


MANAGE _NETWORK _APPLICATION 
Command 


Purpose Initiates a MANAGE_NETWORK_APPLICATIONS utility session. 


Format MANAGE _NETWORK_APPLICATION or 
MANAGE_NETWORK_APPLICATIONS or 
MANNA 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks ® To use this utility, you must be validated by the family administrator. 
For more information, refer to the NOS/VE User Validation manual. 


® Only one user at a time can modify the application definitions file. 
@ NAM/VE need not be active to invoke the MANNA utility. 
@ The prompt for the MANNA utility is: 


mna/ 
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MANNA Subcommands 


MANAGE_NETWORK_APPLICATION 
(MANNA) Utility 


ACTIVATE_CLIENT 
ACTIVATE_SERVER 
CHANGE_CLIENT 
CHANGE_SERVER 
DEACTIVATE_CLIENT 
DEACTIVATE_SERVER 
DEFINE_CLIENT 
DEFINE_SERVER 
DELETE_CLIENT 
DELETE_SERVER 
DISPLAY_APPLICATION_STATUS 
DISPLAY_CLIENT_ATTRIBUTE 
DISPLAY_CLIENT_STATUS 
DISPLAY_SERVER_ATTRIBUTE 
DISPLAY_SERVER_STATUS 
GENERATE_APPLICATION_DEFINITION 
GENERATE_CLIENT_DEFINITION 
GENERATE_SERVER_DEFINITION 
QUIT 


DEFINE_CLIENT DEFINE_SERVER 
and and 
CHANGE_CLIENT CHANGE_SERVER 
Subutilities Subutilities 


CHANGE_APPLICATION_IDENTIFIER ADD_CLIENT_ADDRESS 
CHANGE_CLIENT_VALIDATION ADD_SERVER_MANAGED_TITLE 
CHANGE_CONNECTION_PRIORITY ADD_TITLE 
CHANGE _MAXIMUM_CONNECTIONS CHANGE_ACCEPT_CONNECTION 
DISPLAY_CLIENT_ATTRIBUTES CHANGE_APPLICATION_IDENTIFIER 
END_CHANGE_CLIENT(CHAC only) CHANGE_CLIENT_VALIDATION 
END_DEFINE_CLIENT(DEFC only) CHANGE_CONNECTION_PRIORITY 
GENERATE_CLIENT_DEFINITION CHANGE_MAXIMUM_CONNECTIONS 
CHANGE_SERVER_JOB 
CHANGE_SERVER_VALIDATION 
DELETE_CLIENT_ADDRESS 
DELETE_SERVER_MANAGED_TITLE 
DELETE_TITLE 
DISPLAY_SERVER_ATTRIBUTES 
END_CHANGE_SERVER(CHAS only) 
END_DEFINE_SERVER(DEFS only) 
GENERATE_SERVER_DEFINITION 


Figure 4-1. MANNA Subcommands 
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ACTIVATE_CLIENT 


ACTIVATE _CLIENT 
MANNA Subcommand 


| Purpose Activates a defined client application. 


Format ACTIVATE _CLIENT or 
ACTC 
CLIENT =name 
STATUS =status variable 


Parameters CLIENT or C 


Specifies the name of the client application to be activated. This parameter 
is required. 


STATUS 


Returns the completion status of this subcommand. 


Remarks A client application must be activated before it can make a connection 
request. 
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ACTIVATE_SERVER 


ACTIVATE _SERVER 
MANNA Subcommand 


Purpose Activates a defined server application. 


Format ACTIVATE_SERVER or 
ACTS 
SERVER =name 
STATUS =siatus variable 


Parameters SERVER or S 
Specifies the name of the’server application to be activated. This 
parameter is required. 


STATUS 
Returns the completion status of this subcommand. 

Remarks If the server application is a NAM-initiated server, it must be activated 
before it can receive connection requests from client applications. If the | 


server application is not a NAM-initiated server, it must be executing in 
order to receive connection requests from client applications. 
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ADD..CLIENT_ADDRESS 


ADD _CLIENT_ADDRESS 
DEFS and CHAS Subcommand 


Purpose 


Format 


Parameters 


Specifies a network address to be added to thelist of addresses from which 
client applications are authorized to connect to the server application. 


ADD_CLIENT_ADDRESS or 
ADDCA . 
NETWORK_IDENTIFIER =keyword or integer 
SYSTEM _IDENTIFIER =keyword or integer 
APPLICATION __IDENTIFIER =keyword or integer 
' STATUS =status variable 


NETWORK _IDENTIFIER or NI 


Specifies the network identifier that must be present in the network 
address of a client application in order to connect to the server application. 
The value specified can be a hexadecimal network identifier (integer) in 
the range from 1 to OFFFFFFFF. The keyword ALL can be specified to 
indicate that the network identifier in the client’s address is not to be used 
to limit access to the server application. 


The default value is ALL: 
SYSTEM _IDENTIFIER or SI 


Specifies the system identifier that must be present in the network address 
of a client application in order to connect to the server application. The 
value specified can be a hexadecimal system identifier (integer) in the 
range from 1 to OFFFFFFFFFFFF. The following keyword options are 
available: 


ALL 

Indicates that the system identifier in the client’s address is not to be 
used to limit access to the server application. 

NOSVE 

Indicates that the system identifier of any NOS/VE system is to be 
accepted. 

CDCNET 


Indicates that the system identifier of any CDCNET DI is to be - 
accepted. 


The default value is ALL. 


APPLICATION_IDENTIFIER or AI 


Specifies the application identifier that must be present in the network 
address of a client application in order to connect to the server application. 
The value specified can be an application identifier (integer) in the range 
from 2000 to 3000. The keyword ALL can be specified to indicate thatthe 


‘application identifier in the client’s address is not to be used to limit - 


access to the server application. 


The default is ALL. 


STATUS 


Returns the completion status of this subcommand. 


4-6 Network Management Revision C 


ADD_CLIENT_ADDRESS 


Remarks © Each ADD_CLIENT_ADDRESS subcommand creates an entry in a list 
of valid client addresses. A connection request from a client at a 
network address in the list is processed. A connection request from a 
client at a network address not in the list is rejected by NAM/VE. 


© The DELETE..CLIENT_ADDRESS subcommand removes addresses 
from the list. . 


® Chapter 2 contains additional information on validating connection 
requests based on the client address. 
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ADD_SERVER_MANAGED_TITLE . 


ADD _SERVER_MANAGED_TITLE 
DEFS and CHAS Subcommand 


Purpose Adds one or more title patterns to the list of title patterns that defines the 
set of server titles the server application can manage. 


Format ADD_SERVER_MANAGED_TITLE or 
ADD_SERVER_MANAGED_TITLES or 
ADDSMT 
TITLE _ PATTERN =list of name or string 
STATUS =status variable 


Parameters TITLE_PATTERN or TITLE_PATTERNS or TP. 


Specifies title patterns to be added to the list of title patterns. A title 
pattern can be a name, a string, or a list of names and strings. For more 
information on title patterns, see chapter 2. 


This parameter is required. 
STATUS 


Returns the completion status of this subcommand. 


Remarks The DELETE_SERVER_MANAGED_TITLE subcommand removes title 
patterns from the list of title patterns for the server application. 
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ADD_TITLE 


ADD _TITLE 
DEFS and CHAS Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Revision C 


Adds titles to the list of titles to be registered in the network directory for 
the server application. 


ADD_TITLE or 

ADD_TITLES or 

ADDT 
TITLE=list of name or string 
BROADCAST_REGISTRATION = boolean 
PRIORITY = integer 
DATA =string 
STATUS =status variable 

TITLE or TITLES or T 


Specifies titles to be added to the list of titles for the server application. A 
title can be a name, a string, or a list of names and strings. 


When you specify a name, letters are converted to uppercase before the 
title is registered in the network directory. For more information on | 
creating titles, see chapter 2. 


This parameter is required. 


BROADCAST_REGISTRATION or BR 
Specifies the value of the BROADCAST_REGISTRATION attribute. 


TRUE 
Indicates that title translations should be distributed throughout the 
network once they are registered in the directory. 
FALSE 
Indicates that the title translations are not to be distributed. 
The default is FALSE. 


PRIORITY or P 


Specifies the directory priority associated with the title. You can specify an 
integer from 1 to 255. 


The default is 1, which indicates the highest priority. 


DATA or D 


Specifies the application-specific data to be delivered to the client 
application with a translation of this title. You can specify a string of up. 
to 32 characters. 


The default is no string. 


STATUS 
Returns the completion status of this subcommand. 


The DELETE_TITLE subcommand removes titles from the list of titles for 
the server application. 
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CHANGE_ACCEPT_CONNECTION 


CHANGE _ACCEPT_CONNECTION 
DEFS and CHAS Subcommand 


Purpose Specifies whether NAM/VE should accept connection requests: on behalf of 
the server application. 


Format CHANGE _ACCEPT_CONNECTION or 
CHAAC | 
ACCEPT_CONNECTION = boolean 
STATUS =status variable 
Parameters ACCEPT_CONNECTION or AC 


Specifies the value of the ACCEPT_CONNECTION attribute. 


TRUE 


Indicates that NAM/VE is to accept connection requests before assigning 
the connection to a server application job. 


FALSE 


Indicates that NAM/VE is not to accept connection requests before 
assigning the connection to a server application job. 


The initial value is TRUE. This parameter is required. 
STATUS 


Returns the completion status of this subcommand. 


Remarks The ACCEPT_CONNECTION attribute must be TRUE when both of the 
following conditions are TRUE: 


© The client application is required to supply validation information (by 
either the SERVER_JOB_ VALIDATION_SOURCE attribute or the 
CLIENT_VALIDATION attribute). 


e The validation information must come from a dialog (specified by the 
CLIENT_INFORMATION_ SOURCE attribute). 
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CHANGE_APPLICATION_IDENTIFIER 


CHANGE _APPLICATION _IDENTIFIER 
DEFC and CHAC Subcommand 


Purpose Changes the application identifier used for the client application. 


Format CHANGE_APPLICATION _IDENTIFIER or 
CHAAI 
APPLICATION _IDENTIFIER = keyword or integer 
STATUS =status variable 


Parameters APPLICATION _IDENTIFIER or AI 


Specifies the value of the APPLICATION_IDENTIFIER attribute. The 
value specified can be an integer in the range from 2000 to 3000. The 
keyword VARIABLE can be specified to indicate that the application 
identifier is to be assigned from a pool of values when the client 
application is initiated. 


The initial value is VARIABLE. This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 
Remarks ® If you use the CHANGE_APPLICATION_IDENTIFIER subcommand to 
change the application identifier of an active client, this change affects 


only those new connections created after the changed client definition is 
saved. 


e If the keyword VARIABLE is specified, a different value can be 
assigned each time the application is activated. 
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CHANGE_APPLICATION_IDENTIFIER 


CHANGE _APPLICATION _IDENTIFIER 
DEFS and CHAS Subcommand 


Purpose Changes the application identifier used for the server application. 


Format CHANGE_APPLICATION IDENTIFIER or 
CHAAI | 
APPLICATION _IDENTIFIER=keyword or integer 
STATUS =status variable 


Parameters APPLICATION_IDENTIFIER or Al 


Specifies the value of the APPLICATION_IDENTIFIER attribute. The 
value specified can be an integer in the range from 2000 to 3000. The 
keyword VARIABLE is specified to indicate that the application identifier 
is to be assigned from a pool of values when the server application is 
initiated. 


The initial value is VARIABLE. This parameter is required. 
STATUS 
Returns the completion status of this subcommand. 
Remarks © If you use the CHANGE_APPLICATION_IDENTIFIER subcommand to 
change the application identifier of an active server, this change affects 


only those new connections created after the changed server definition 
is saved. 


@ If the keyword VARIABLE is specified, a different value can be 
assigned each time the application is activated. 


@e The SCFS/VE application name (default name of OSA$STATUS_ 
CONTROL_FAC_SERVER) should be deactivated before its application 
identifier is changed. 
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CHANGE_CLIENT 


CHANGE _CLIENT 
MANNA Subcommand 


Purpose Initiates a CHANGE_CLIENT subutility session that changes the 
definition of an existing client application. 


Format CHANGE _CLIENT or 
CHAC 
CLIENT = name 
STATUS =status variable 


Parameters CLIENT or C 
Specifies the name of the client application whose definition is to be 


changed. This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


Remarks @ The CHANGE_CLIENT subutility prompt is: 
chac/ 


@ While you are in a CHANGE_CLIENT subutility session, you can use 
the following subcommands to change the application’s attributes: 


CHANGE_APPLICATION_IDENTIFIER 
CHANGE_CLIENT_ VALIDATION 
CHANGE_CONNECTION_ PRIORITY 
CHANGE_MAXIMUM_CONNECTIONS 


@ When you end the CHANGE_CLIENT subutility with the END_ 
CHANGE_CLIENT subcommand, you have the option of either making 
the. changes permanent or discarding the changes you have made. 
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CHANGE_CLIENT_VALIDATION " 


CHANGE _CLIENT_VALIDATION 
DEFC and CHAC Subcommand 


Purpose Changes the client validation that NAM/VE performs to verify that the 
user of the client application is authorized to perform the functions of the 
client application. 


Format CHANGE_CLIENT_VALIDATION or 
CHACV 
CAPABILITY =keyword or name 
RING = integer 
SYSTEM_PRIVILEGE = boolean 
STATUS =status variable 


Parameters CAPABILITY or C 


Specifies the name of.the CLIENT_CAPABILITY attribute that must be in 
the calling user’s validation file entry in order to call the affected 
NAM/VE program interfaces. The keyword NONE can be specified to 
indicate that no capability is to be validated. | 


The initial value is NONE. If you omit this parameter, the current value 
is not changed. 

RING or R 

Specifies the value of the CLIENT_RING attribute. It is the maximum 
ring number from which the affected NAM/VE program interfaces can be 
called. You can specify an integer in the range from 1 to 15. The initial 
value is 13. If you omit this parameter, the current value is not changed. 
SYSTEM_PRIVILEGE or SP 

Specifies the value of the CLIENT_SYSTEM. PRIVILEGE attribute. 


TRUE 

Indicates that the affected NAM/VE interfaces can be called only by 
code with a system privilege. 

FALSE 


Indicates that the affected NAM/VE interfaces can be called by any 
code. 


The initial value is FALSE. If you omit this parameter, the current value 
is not changed. 


NOTE 
The SYSTEM_PRIVILEGE parameter is not operational for the current 
release of NOS/VE. 


STATUS 
Returns the completion status of this subcommand. 
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CHANGE_CLIENT_VALIDATION 


CHANGE _ CLIENT_VALIDATION 
DEFS and CHAS Subcommand 


Purpose - Specifies whether NAM/VE should perform client validation on behalf of 
the server application. 


Format CHANGE _CLIENT_VALIDATION or 
CHACV 
CAPABILITY=keyword or name 
STATUS =status variable 


Parameters CAPABILITY or C 


Specifies the name of the CLIENT_ VALIDATION attribute that must be 
present in the client’s validation file entry. The keyword NONE can be 
specified to indicate that NAM/VE is not to perform client validation. 


The initial value is NONE. This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


Remarks See chapter 2 for additional information about client validation. 
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CHANGE_CONNECTION_ PRIORITY 


CHANGE _CONNECTION _PRIORITY 
DEFC and CHAC Subcommand 


Purpose 


Format 


Parameters 


Remarks 


‘Changes the priority associated with the client application’s connections. 


CHANGE_CONNECTION _PRIORITY or. 

CHACP 
CONNECTION _ PRIORITY = integer 
STATUS =status variable 


CONNECTION _PRIORITY or CP 


Specifies the value of the CONNECTION_PRIORITY attribute. You can 
specify an integer from 0 through 11. Zero is the lowest priority, and 11 is 
the highest priority. 


This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


e If you use the CHANGE_CONNECTION_PRIORITY subcommand to 
change the connection priority of an active client, the new connection 
priority applies only to those connections created after the changed 
client definition is saved. 


® Connection priority has no effect on NAM/VE processing of connection 
data. However, connection priority does affect CDCNET processing of 
connection data. 


© The NAM/VE priority values from 0 through 11 map into the priority 
values supported by CDCNET as follows: 


NAM/VE Connection 


Priority CDCNET 
0-4 Batch 

5 - 8 Interactive 
9-11 Realtime 


® If an application has a requirement for a very low transfer delay, you 


should specify a value from 9 to 11 in the CONNECTION _ PRIORITY 
parameter of the CHANGE_CONNECTION_PRIORITY subcommand. If 
an application transfers relatively small amounts of data and has a 
requirement for a low transfer delay, you should specify a value from 5 
to 8 in the CONNECTION_PRIORITY parameter. If an application 
transfers large amounts of data, you should specify a value from 0 to 4 
in the CONNECTION PRIORITY parameter. 
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CHANGE_CONNECTION_PRIORITY 


CHANGE _CONNECTION _ PRIORITY 
DEFS and CHAS Subcommand 


Purpose Changes the priority associated with the server application’s connections. 


Format CHANGE _CONNECTION_PRIORITY or 
CHACP 
CONNECTION _ PRIORITY = integer 
STATUS =status variable 


Parameters CONNECTION_PRIORITY or CP 


Specifies the value of the CONNECTION_PRIORITY attribute. You can 
specify an integer from 0 through 11. Zero is the lowest priority, and 11 is 
the highest priority. . 


This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


Remarks ® If you use the CHANGE_CONNECTION_ PRIORITY subcommand to 
: change the connection priority of an active server, the new connection 
priority applies only to those connections created after the changed 
server definition is saved. 


© Connection priority has no effect on NAM/VE processing of connection 
data. However, connection priority does affect CDCNET processing of 
connection data. 


@® The NAM/VE priority values from 0 through 11 map into the priority 
values supported by CDCNET as follows: 


NAM/VE Connection 


Priority CDCNET 
0-4 Batch 

5 - 8 Interactive 
9-11 Realtime 


© If an application has a requirement for a very low transfer delay, you 
should specify a value from 9 to 11 in the CONNECTION _ PRIORITY 
parameter of the CHANGE_CONNECTION_PRIORITY subcommand. If 
an application transfers relatively small amounts of data and has a 
requirement for a low transfer delay, you should specify a value from 5 
to 8 in the CONNECTION_PRIORITY parameter. If an application _ 
transfers large amounts of data, you should specify a value from 0 to 4 
in the CONNECTION_PRIORITY parameter. 
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CHANGE_MAXIMUM_CONNECTIONS 


CHANGE _MAXIMUM_CONNECTIONS 
DEFC and CHAC Subcommand 


Purpose Changes the maximum number of concurrent connections that can be 
established by all instances of the client application. 


Format CHANGE_MAXIMUM _CONNECTIONS or 
CHAMC 
MAXIMUM_CONNECTIONS = integer 
STATUS =status variable 


Parameters MAXIMUM_CONNECTIONS or MC 
Specifies the value of the MAXIMUM_CONNECTIONS attribute. The 
value indicates the total number of concurrent connections allowed to all 
instances of the client application. You can specify an integer in the range 
from 1 to 65,535. The initial value is 65,535. This parameter is required. 
STATUS 
Returns the completion status of this subcommand. 

Remarks If you use the CHANGE_MAXIMUM_CONNECTIONS subcommand to 


change the maximum connection limit for the client to a value lower than 
the client’s active count, the following occurs: 


@ The utility accepts no new connections until the active connection count 
is less than the new maximum connection limit. 


@ Excess connections are not terminated. 
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CHANGE_MAXIMUM_CONNECTIONS 


CHANGE _MAXIMUM _CONNECTIONS 
DEFS and CHAS Subcommand 


' Purpose 


Format 


Parameters 


Remarks 


Revision C 


Changes: the maximum number of concurrent connections that can be 
established by all instances of the server application. 


CHANGE_MAXIMUM_CONNECTIONS or 
CHAMC 
MAXIMUM CONNECTIONS = integer 
STATUS =status variable 


MAXIMUM _CONNECTIONS or MC 


Specifies the value of the MAXIMUM_CONNECTIONS attribute. The 
value indicates the total number of concurrent connections allowed to all 
instances of the server application. You can specify an integer in the range 
from 1 to 65,535. The initial value is 65,535. This parameter is required. 


STATUS 

Returns the completion status of this subcommand. 

@ For a server application that is self-initiated, a request to initiate a 
new instance of the server application is rejected when enough 


instances to support the total number of allowed connections are 
already active. 


© If you use the CHANGE_MAXIMUM_CONNECTIONS subcommand to 
change the maximum connection limit for the server to a value lower 
than the server’s active count, the following occurs: 


- The utility accepts no new connections until the active connection 
count is less than the new maximum connection limit. 


— Excess connections are not terminated. 
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CHANGE_SERVER 


CHANGE _SERVER 
MANNA Subcommand 


Purpose Initiates a CHANGE_SERVER subutility session that changes the — 
definition of an existing server application. 


Format CHANGE._SERVER or 
CHAS 
SERVER =name 
STATUS =status variable 


Parameters SERVER or S 


Specifies the name of the server application whose definition is to be 
changed. This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


Remarks @ The CHANGE_SERVER subutility prompt is: 
chas/ 


@ While you are in a CHANGE_SERVER subutility session, you can use 
the following subcommands to change the application’s attributes: 


- ADD_CLIENT_ADDRESS 

- ADD_SERVER_MANAGED-_TITLE 

- ADD_TITLE 

- CHANGE_ACCEPT_CONNECTION 

- CHANGE_APPLICATION_IDENTIFIER 
- CHANGE_CLIENT_ VALIDATION 

- CHANGE_CONNECTION_PRIORITY 

- CHANGE_MAXIMUM_CONNECTIONS 
- CHANGE_SERVER_JOB 

- CHANGE_SERVER_ VALIDATION 

- DELETE_CLIENT_ADDRESS 

- DELETE_SERVER_.MANAGED_ TITLE 
- DELETE_TITLE | 


@ When you end the CHANGE_SERVER subutility with the END_ 


CHANGE_SERVER subcommand, you have the option of either making | 
the changes permanent or discarding the changes you have made. 
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CHANGE_SERVER_JOB 


CHANGE _SERVER_JOB 
DEFS and CHAS Subcommand 


Purpose 


Format 


Parameters 


Revision C 


Changes the contents or attributes of the job submitted by NAM/VE when 
NAM/VE initiates an instance of the server application. This subcommand 
can be used only for server applications initiated by NAM/VE. 


CHANGE_SERVER_JOB or 

CHASJ 
JOB =file 
VALIDATION_SOURCE= peers 
MAXIMUM _ CONNECTIONS = integer 
INCLUDE_COMMANDS_ UNTIL =string 
STATUS =status variable 


JOB or J 


Specifies the value of the SERVER_JOB attribute (the name of the file 
that contains the server job). The file you specify contains SCL commands 
that execute an instance of the server application. The initial value is a 
null file (no list of SCL commands). If you omit this parameter, the 
current value is not changed. . 


VALIDATION__SOURCE or VS 
Specifies the value of the SERVER_JOB_ VALIDATION _ SOURCE 


attribute. The following keywords can be specified: 


CLIENT or C 


Indicates that NAM/VE is to poncvate a LOGIN command from 
information supplied by the client. (Information is obtained from the 
client as specified by the CLIENT_INFORMATION_SOURCE 
attribute.) 


SERVER or S 


Indicates that the first command in the list of SCL commands specified 
by the SERVER_JOB attribute must be a valid LOGIN command. 


The initial value is SERVER. If you omit this parameter, the current value 
is not changed. 


MAXIMUM_CONNECTIONS or MC 


Specifies the value of the SERVER_JOB_ MAXIMUM_CONNECTIONS 
attribute. This value indicates the number of concurrent connections 
supported by an instance of the server application. You can specify an 
integer from 1 to 65,535. The initial value is 65,535. If you omit this 
parameter, the current value is not changed. 


INCLUDE_COMMANDS_UNTIL or ICU 


Specifies the value of the INCLUDE_COMMANDS_UNTIL attribute. If 
the file specified by the JOB parameter is $COMMAND, the commands 
that are to make up the server job are read from the current command file 
until a line consisting solely of the string specified by the INCLUDE_ 
COMMANDS_UNTIL parameter is encountered. 


STATUS 
Returns the completion status of this subcommand. 
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CHANGE_SERVER_JOB 


‘Remarks @ The user name and family name specified on the LOGIN command in 
the server application job is used to establish validation limits for the 


server job. Any prologs defined for that user are executed as part of job 
startup. 


@ The server job commands are maintained in the catalog 
$SYSTEM.NETWORK.APPLICATION.JOB. The server name is the 
name of the file. 
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CHANGE_SERVER_ VALIDATION 


CHANGE _SERVER_VALIDATION 
DEFS and CHAS Subcommand 


Purpose Changes the server validation that NAM/VE performs to verify that the 
application is authorized to execute the functions of the server application. 


Format CHANGE_SERVER_VALIDATION or 
CHASV 
CAPABILITY =keyword or name 
RING = integer 
SYSTEM _ PRIVILEGE = boolean 
STATUS =status variable 


Parameters CAPABILITY or C 


Specifies the name of the SERVER _CAPABILITY attribute that must be in 
the calling user’s validation file entry in order to call the affected 
NAM/VE program interfaces. The keyword NONE can be specified to 
indicate that no capability is to be validated. 


The initial value is NONE. If you omit this parameter, the current value 
is not changed. 

RING or R 

Specifies the value of the SERVER_RING attribute. It is the maximum 
ring number from which the affected NAM/VE program interfaces can be 
called. You can specify an integer in the range from 1 to 15. The initial 
value is 13. If you omit this parameter, the current value is not changed. 
SYSTEM_PRIVILEGE or SP 

Specifies the value of the SERVER_SYSTEM_PRIVILEGE attribute. 


TRUE 


Indicates that the affected NAM/VE interfaces can be called only by | 
code with a system privilege. 


FALSE 


Indicates that the affected NAM/VE interfaces can be called by any 
code. 


The initial value is FALSE. If you omit this parameter, the current value 
is not changed. 


NOTE 


The SYSTEM_PRIVILEGE parameter is not operational for the current 
release of NOS/VE. 


STATUS 
Returns the completion status of this subcommand. 
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DEACTIVATE_CLIENT 


DEACTIVATE _CLIENT 
MANNA Subcommand 


Purpose Deactivates an active client application. 


Format DEACTIVATE_CLIENT or 
DEAC 
CLIENT = name 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 
Parameters CLIENT or C 
Specifies the name of the client application to be deactivated. This 
parameter is required. 
TERMINATE_ACTIVE_CONNECTIONS or TAC 
Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 
TRUE 


Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default is FALSE. 
STATUS 


Returns the completion status of this subcommand. 


Remarks Following entry of this subcommand, no new connections can be established 
by the client application. 
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DEACTIVATE_SERVER — 


DEACTIVATE _SERVER 
MANNA Subcommand 


Purpose Deactivates an active server application. 


Format DEACTIVATE_SERVER or 
DEAS 
SERVER= name 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 
Parameters SERVER or S 
Specifies the name of the server application to be deactivated. This 
parameter is required. 
TERMINATE_ACTIVE_CONNECTIONS or TAC 
Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 
TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks Following entry of this subcommand, no new connections can be established 
to the server application. 


Revision C_ MANAGE_NETWORK_APPLICATIONS Command and Subcommands 4-25 


DEFINE_CLIENT- 


DEFINE _CLIENT 
MANNA Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Initiates a DEFINE_CLIENT subutility session which defines a client 
application. 


DEFINE _CLIENT or 
DEFC 
CLIENT = name 
PROTOCOL= keyword 
STATUS =status variable 


CLIENT or C 

Specifies the name of the client application to be defined. This parameter 
is required. 

PROTOCOL or P 

Specifies the protocol used by the application. 


CDNA_SESSION or CS 


The CS protocol is used by applications that communicate over 
host-to-host connections. 


CDNA_VIRTUAL.TERMINAL or CVT 


The CVT protocol is used by applications that communicate with 
CDCNET-connected terminals. 


This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


© When you initiate a DEFINE_CLIENT subutility session, the subutility 
checks the list of defined applications to make sure that no server or 
client application with the same name exists. When you end the 
subutility, the new client application definition is added to the list of 
defined applications. 


© The DEFINE_CLIENT subutility prompt is: 
defc/ 


@ While you are in DEFINE_CLIENT subutility session, you can use the 
following subcommands to change the application’s attributes: 


- CHANGE_APPLICATION_IDENTIFIER 
- CHANGE_CLIENT_ VALIDATION 

- CHANGE_CONNECTION_ PRIORITY 

- CHANGE. MAXIMUM_CONNECTIONS 


© When you end the DEFINE_CLIENT subutility with the END_ 
DEFINE_CLIENT subcommand, you have the option of making the 
changes permanent or discarding the changes you have made. 


© The defined client application is inactive until you activate it with the 
ACTIVATE_CLIENT subcommand. 
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DEFINE_SERVER © 


DEFINE _SERVER 
MANNA Subcommand 


Purpose Initiates a DEFINE_SERVER subutility session which defines a server 
application. 


Format DEFINE_SERVER or 
DEFS 
SERVER= name 
PROTOCOL=keyword 
NAM _INITIATED = boolean 
STATUS =status variable 
Parameters SERVER or S 
Specifies the name of the server application to be defined. This parameter 
is required. 
PROTOCOL or P 


Specifies the protocol used by the application. 
CDNA_SESSION or CS 


- The CS protocol is used by applications that communicate over 
host-to-host connections. 
CDNA_VIRTUAL_TERMINAL or CVT 


The CVT protocol is used by applications that communicate with 
CDCNET-connected terminals. 


This parameter is required. 


NAM_INITIATED or NI 
Specifies the value of the NAM_INITIATED attribute. 


TRUE 


Indicates that NAM/VE is to initiate an instance of the server 
application when it is necessary to service a connection request from a 
client application. 


FALSE 


Indicates that an application-specific mechanism (user-intitiated) is to 
initiate an instance of the server application. 


The default is TRUE. 


STATUS 
Returns the completion status of this subcommand. 
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DEFINE_SERVER 


Remarks @ When you initiate a DEFINE_SERVER subutility session, the © 
subutility checks the list of defined applications to make sure that no 
server or client application with the same name exists. When you end 
the subutility, the new server application definition is added to the list 
of defined applications. 


@ The DEFINE_SERVER subutility prompt is: 
defs/ 


@ While you are in the DEFINE_SERVER subutility session, you can use 
the following subcommands to change the application’s attributes: 


- ADD_CLIENT_ADDRESS 

- ADD_SERVER_MANAGED-_TITLE 

- ADD _TITLE 

- CHANGE_ACCEPT_CONNECTION 

- CHANGE_APPLICATION_IDENTIFIER 
- CHANGE_CLIENT_ VALIDATION 

- CHANGE_CONNECTION_ PRIORITY 

- CHANGE. MAXIMUM_CONNECTIONS 
- CHANGE_SERVER_JOB 

- CHANGE_SERVER_ VALIDATION 

- DELETE_CLIENT_ADDRESS 

- DELETE_SERVER_MANAGED_TITLE 
- DELETE_TITLE 


@ When you end the DEFINE_SERVER subutility with the END_ 
DEFINE_SERVER submcommand, you have the option of either 
making the changes permanent or discarding the changes you have 
made. 


© The defined server application is inactive until you activate it with the 
ACTIVATE_SERVER subcommand. 
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DELETE_CLIENT .. 


DELETE _CLIENT 
MANNA Subcommand 


Purpose Deletes the definition of a client application. 


Format DELETE _CLIENT or 
DELC 
CLIENT =name 
STATUS =status variable 


Parameters CLIENT or C 
Specifies the name of the client application whose definition is to be 
deleted. This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 

Remarks Before you can delete a client application definition, the client application 
must be inactive and have no active connections. To deactivate a client 


application, you specify TRUE on the TERMINATE_ACTIVE_ 
CONNECTIONS parameter of the DEACTIVATE_CLIENT subcommand. 
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DELETE. CLIENT_ ADDRESS 


DELETE _CLIENT_ADDRESS 
DEFS and CHAS Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Specifies a network address to be deleted from the list of addresses from 
which client applications are authorized to connect to the server 


_ application. 


DELETE _CLIENT_ADDRESS or 

DELCA 
NETWORK_IDENTIFIER =keyword or integer 
SYSTEM_IDENTIFIER =keyword or integer 
APPLICATION _IDENTIFIER = keyword or integer 
STATUS =status variable 


NETWORK_IDENTIFIER or NI 


Specifies the network identifier of the address to be deleted. The value 
specified can be a hexadecimal network identifier (integer) in the range 
from 1 to OFFFFFFFF. The keyword ALL can be specified to indicate that 
all network indentifiers are specified in the network address to be deleted. 


The default is ALL. 


SYSTEM _IDENTIFIER or SI 


Specifies the system identifier of the address to be deleted. The value 
specified can be a hexadecimal system identifier (integer) in the range 
from 1 to OFFFFFFFFFFFF. The following keyword options are available: 


ALL 

Indicates that all system identifiers are specified in the network address 
to be deleted. 

NOSVE 

Indicates that the system identifier of any NOS/VE system is specified 
in the network address to be deleted. 

CDCNET 


Indicates that the system identifier of any CDCNET DI is specified in 
the network address to be deleted. 


The default is ALL. 


APPLICATION_IDENTIFIER or AI 


Specifies the application identifier of the address to be deleted. The value 
specified can be an integer in the range from 2000 to 3000. The keyword 
ALL can be specified to indicate that all application identifiers are 
specified in the network address to be deleted. 


The default is ALL. 
STATUS 


Returns the completion status of this subcommand. 


The network address specified must match exactly an address that was 
previously placed in the list of authorized addresses by the ADD_ 
CLIENT_ADDRESS subcommand. Refer to chapter 2 for more information 
on validating connection requests based on a client address. 
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DELETE_SERVER 


DELETE _SERVER 
MANNA Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Revision C 


Deletes the definition of a server application. 


DELETE_SERVER or 
DELS 
SERVER = name 
STATUS =status variable 


SERVER or S 


Specifies the name of the server application whose definition is to be 
deleted. This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


Before you can delete a server application definition, the server application 
must be inactive and have no active connections or attached server jobs. To 
deactivate a server application, you specify TRUE on the TERMINATE_ 
ACTIVE._CONNECTIONS parameter of the DEACTIVATE_SERVER> 
subcommand. It may be necessary to use the TERMINATE_JOB SCL 
command to detach any active server application jobs. See the NOS/VE 
System Usage manual for more information about the TERMINATE_JOB 
command. 


MANAGE_NETWORK_APPLICATIONS Command and Subcommands 4-31 


DELETE_SERVER_MANAGED_TITLE 


DELETE _SERVER_MANAGED_TITLE 
DEFS and CHAS Subcommand 


Purpose Deletes one or more title patterns from the list of title patterns that 
defines the set of server titles the server application can manage. 


Format DELETE. SERVER_MANAGED_TITLE or 
DELETE _SERVER_MANAGED_TITLES or 
DELSMT 
TITLE _ PATTERN =list of name or pi ae 
STATUS =status variable , 


Parameters TITLE_PATTERN or TITLE_PATTERNS or TP 


Specifies title patterns to be deleted from the list of title patterns. A title 
pattern can be a name, a string, or a list of names and strings. For more 
information on.title patterns, see chapter 2. 


This parameter is required. 


STATUS 


Returns the completion status of this subcommand. 


Remarks The ADD_SERVER_MANAGED_TITLE subcommand adds title patterns 
to the list of title patterns for the server application. 
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DELETE_TITLE 


DELETE _ TITLE 
DEFS and CHAS Subcommand 


Purpose Deletes titles from the list of titles to be registered in the network 
directory for the server application. 


Format DELETE _ TITLE or 
DELETE _TITLES or 
DELT 
TITLE =list of name or string 
STATUS =status variable 


Parameters TITLE or TITLES or T 


Specifies one or more titles to be deleted from the list of titles for the 
server application. A title can be a name, a string, or a list of names and 
strings. For more information on titles, see chapter 2. 


This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The ADD_TITLE subcommand adds titles to the list of titles for the server 
application. 
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DISPLAY_APPLICATION_STATUS 


DISPLAY_APPLICATION _STATUS 
MANNA Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Examples 


Displays status information for one or more defined server and client - 
applications. 


DISPLAY_APPLICATION_STATUS or 
DISAS 
APPLICATION =keyword or list of name 
OUTPUT =file | 
STATUS =status variable 


APPLICATION or APPLICATIONS or A 


Specifies the names of one or more applications for which status is to be 
displayed. The keyword ALL can be specified to display the status of all 
applications. 


The default value is ALL. 


OUTPUT or O 


Specifies the file on which the displayed information is to be written. The 
default is $OUTPUT. 


STATUS 
Returns the completion status of this subcommand. 


© The status information displayed includes: 
- an indication of whether the application is active or inactive, 
- the number of active connections for the application, and 
- the names of jobs in which the application is active. 

@ NAM/VE must be active in order to display status information. 


The following DISPLAY_APPLICATION_STATUS subcommand generates 
the output display shown below: 


mna/display_application_status osa$t imesharing 


Server: OSA$TIMESHARING 
Status: active 
Act ive_server_connect ions: 3 
Server_added_titiles: None 
Act ive_server_jobs: 0 
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DISPLAY_CLIENT_ATTRIBUTE 


DISPLAY_CLIENT_ATTRIBUTE 
MANNA, DEFC, and CHAC Subcommand 


Purpose 


Format 


Parameters 


Revision C 


Displays attribute values for defined client applications. 


DISPLAY_CLIENT_ATTRIBUTE or 
DISPLAY_CLIENT_ATTRIBUTES or 
DISCA ; 

CLIENT =keyword or list of name 
DISPLAY_OPTION =list of keyword 
OUTPUT =file . 

STATUS =status variable 


CLIENT or C 


Specifies the names of one or more client applications for which attributes 
are to be displayed. The keyword ALL can be specified to display the 
attributes of all client applications. 

The default value is ALL if used outside of the DEFINE_CLIENT or 
CHANGE_CLIENT subutility. When used inside of the DEFINE_CLIENT 
or CHANGE_CLIENT subutility, the client application currently being 
defined or changed is the default. 


DISPLAY_OPTION or DISPLAY_OPTIONS or DO 


Specifies the attribute values to be displayed. For a description of client 
application attributes, see table 3-3. 


Options are one or more of the following keywords: 


ALL 

APPLICATION _IDENTIFIER or AI 
CLIENT_CAPABILITY or CC 
CLIENT_RING or CR 
CLIENT_STATUS or CS 
CLIENT_SYSTEM_ PRIVILEGE or CSP 
CONNECTION_ PRIORITY or CP 
MAXIMUM_CONNECTIONS or MC 
PROTOCOL or P 


The attribute value ALL displays all attribute values. The default is ALL. 


OUTPUT or O 


Specifies the file on which the displayed information is to be written. The 
default is $OUTPUT. 


STATUS 
Returns the completion status of this subcommand. 
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DISPLAY_CLIENT_ATTRIBUTE 


Examples The following DISPLAY_CLIENT_ATTRIBUTE subcommand generates the 


output display shown below: 


mna/display_client_attributes client=osa$file_transfer_client 


Client: 
Status: 
Protocol: 
Applicat ion_Identifier: 
Maximum_connect ions: 
Connect ion_priority: 
Client_capabi lity: 
Client_ring: 


Client_system_pr ivi lege: 
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OSA$FILE_TRANSFER_CLIENT 
active 

cdna_session 

2001 

40 


TRUE 
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DISPLAY_CLIENT_STATUS 


DISPLAY_CLIENT_STATUS 
MANNA Subcommand 


Purpose Displays status information for defined client applications. 


Format DISPLAY_CLIENT_STATUS or 
DISCS 
CLIENT =keyword or list of name 
OUTPUT = file 
STATUS =status variable 
Parameters CLIENT or C 


Specifies the names of one or more client applications for which status is 
to be displayed. The keyword ALL can be specified to display the status of 
all client applications. 


The default value is ALL. 


OUTPUT or O 


Specifies the file on which the displayed information is to be written. The 
default is $OUTPUT. 


STATUS 
Returns the completion status of this subcommand. 


Remarks ® The status information displayed includes: 


- an indication of whether the client application is active or inactive 
and 


- the number of active connections for the client application. 
@ NAM/VE must be active in order to display status information. 


Examples The following DISPLAY_CLIENT_STATUS subcommand generates the 
output display shown below: 


mna/display_client_status client=osa$file_transfer_client 


Client: OSA$FILE_TRANSFER_CLIENT 
Status: active 
Active_client_connections: 0 
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DISPLAY_SERVER_ATTRIBUTE 


DISPLAY_SERVER_ATTRIBUTE 
MANNA, DEFS, and CHAS Subcommand 


Purpose Displays attribute values for defined server applications. 


Format DISPLAY_SERVER_ATTRIBUTE or 
DISPLAY_SERVER_ATTRIBUTES or 
DISSA 
SERVER =keyword or list of name 
DISPLAY_OPTION =list of keyword 
OUTPUT =file 
STATUS =status variable 


Parameters SERVER or S 


Specifies the names of one or more server applications for which attributes 
are to be displayed. The keyword ALL can be specified to display the 
attributes of all server applications. 


The default value is ALL if used outside of the DEFINE_SERVER or 
CHANGE_SERVER subutility. The server application currently being 
defined or changed is the default if you enter the subcommand within the 
DEFINE_SERVER or CHANGE._SERVER subutility. 


DISPLAY_OPTION or DISPLAY_OPTIONS or DO 


Specifies the attribute values to be displayed. For a description of server 
application attributes, see table 3-4. Options are one or more of the 
following keywords: 


ACCEPT_CONNECTION or AC 

ALL 

APPLICATION_IDENTIFIER or AI 
CLIENT_ADDRESS or CLIENT_ADDRESSES or CA 
CLIENT_INFO_SOURCE or CIS 
CLIENT_VALIDATION or CV 
CONNECTION_PRIORITY or CP 
MAXIMUM_CONNECTIONS or MC 
NAM_INITIATED or NI 

PROTOCOL or P 

SERVER_CAPABILITY or SC 

SERVER_JOB or SJ 
SERVER_JOB_MAXIMUM_CONNECTIONS or SJMC 
SERVER_JOB_ VALIDATION_SOURCE or SJVS 
SERVER_MANAGED-_TITLE or SERVER_MANAGED_TITLES or 
SMT tos 
SERVER_RING or SR 
SERVER_SYSTEM_PRIVILEGE or SSP 
SERVER_STATUS or SS 

TITLE or TITLES or T 

TITLE_ATTRIBUTE or TITLE_ATTRIBUTES or TA 


The attribute value ALL displays all attribute values. The attribute value 
TITLE_ATTRIBUTES displays the TITLE_PRIORITY, BROADCAST_ 
REGISTRATION, and TITLE_DATA attributes for each title. The default is 
ALL. 
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Examples 


Revision C 


OUTPUT or O 


DISPLAY_SERVER_ATTRIBUTE 


Specifies the file on which the displayed information is to be written. The 


default is $OUTPUT. 
STATUS 


Returns the completion status of this subcommand. 


The following DISPLAY_SERVER_ATTRIBUTE subcommand generates the 


output display shown below: 


mna/display_server_attributes server=osa$file_transfer_server 


Server: 

Status: 

Protocol: 

Applicat ion_Identifier: 

Maximum_connections: 

Connection_priority: 

Server_capability: 

Server_ring: 

Server_system_privilege: 

Title: 
Broadcast_registration: 
Title_priority: 
Title_data: 

Title: 
Broadcast_registration: 
Title_priority: 
Title_data: 

Title: 
Broadcast_registration: 
Title_priority: 
Title_data: 

Server_managed_titles: 

Accept_connection: 

Client_validation: 

Ciient_informat ion_source: 

Client_addresses: 

NAM_Initiated: 


OSA$FILE_TRANSFER_SERVER 
active 
cdna_session 
Variable 

40 

0 

None 

13 

TRUE 
PTFS$NVEDEV 
FALSE 

1 

None 
PTFS$TESTVE830631 
FALSE 

1 

None 

PTFS$VN1 
FALSE 

1 

None 

None 

FALSE 

None. 

dialog 

all addresses 
FALSE 
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DISPLAY_SERVER_STATUS 


DISPLAY_SERVER_STATUS 
MANNA Subcommand 


Purpose Displays status information for defined server applications. 


Format DISPLAY_SERVER_STATUS or 
DISSS 
SERVER =keyword or list of name 
OUTPUT =file 
STATUS =status variable 


Parameters SERVER or S 


Specifies the names of one or more server applications for which status is 
to be displayed. The keyword ALL can be specified to display the status of 
all server applications. 


The default value is ALL. 


OUTPUT or O 


Specifies the file on which the panayens information is to be written. The 
default is $OUTPUT. 


STATUS , 
Returns the completion status of this subcommand. 


~ Remarks e@ The status information displayed by this subcommand includes: 
- an indication of whether the server application is active or inactive, 


- the names of jobs in which the application is active (server 
application jobs), 


- a list of currently active server managed titles, and 
- the number of active connections for each server job. 
© NAM/VE must be active in order to display status information. 


Examples The following DISPLAY_SERVER_STATUS subcommand generates the 
output display shown below: 


mna/display_server_status server=osa$file_transfer_server 


Server: OSA$FILE_TRANSFER_SERVER 
Status: active 
Active_server_connect ions: 0 
Server_added_tit les: None 
Active_server_jobs: 1 

Job name Connections 
$0830_0631_AAA_0000 0 
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END_CHANGE_ CLIENT 


END _CHANGE _CLIENT 
CHAC Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Revision C 


Ends a CHANGE_CLIENT subutility session. 


END_CHANGE_CLIENT or 
ENDCC or 

QUIT or 

QUI 


SAVE _DEFINITION = boolean 
STATUS =status variable 


SAVE_DEFINITION or SD 


Specifies whether to save or discard the changes you have made to the 
client definition. 


TRUE 
Indicates that the client definition is to be saved. 


FALSE 
Indicates that the client definition is to be discarded. 


The default is TRUE. 


STATUS 


' Returns the completion status of this subcommand. 


When the client application definition is to be saved, the definition is 
checked for errors. The CHANGE_CLIENT subutility session does not 
end if errors are found. The subutility issues a message documenting 

the problem. (You can enter subcommands to correct the problem.) A 

definition in error is never saved. 


The client definition is recorded in the 
$SYSTEM.NETWORK.APPLICATION.DEFINITIONS file when this 
subcommand executes successfully. The definition remains in effect until 
explicitly deleted. 
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END_CHANGE_SERVER 


END_CHANGE_SERVER 
CHAS Subcommand 


Purpose Ends a CHANGE_SERVER subutility session. 


Format END_CHANGE SERVER or 
ENDCS or 
QUIT or 
QUI 
SAVE _DEFINITION = boolean 
STATUS =status variable 


Parameters SAVE_DEFINITION or SD 
Specifies whether to save or discard the changes you have made to the 
server definition. 


TRUE 


Indicates. that the server definition is to be saved. 


FALSE 
Indicates that the server definition is to be discarded. 
The default is TRUE. 


STATUS 


Returns the completion status of this subcommand. 


Remarks @ When the server application definition is to be saved, the definition is 
checked for errors. The CHANGE_SERVER subutility session does not 
end if errors are found. The subutility issues a message documenting 
the problem. (You can enter subcommands to correct the problem.) A 
definition in error is never saved. | 


@ The server definition is recorded in the 
$SYSTEM.NETWORK.APPLICATION. DEFINITIONS. file when this 
subcommand executes successfully. The definition remains in effect until 
explicitly deleted. 
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END_DEFINE_ CLIENT 


END _ DEFINE _CLIENT 
DEFC Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Revision C 


Ends a DEFINE_CLIENT subutility session. 


END _DEFINE_CLIENT or 
ENDDC or 
QUIT or 
QUI 
SAVE _ DEFINITION = boolean 
STATUS =status variable 


SAVE_DEFINITION or SD 


Specifies whether to save or discard the changes you have made to the 
client definition. 


TRUE 
Indicates that the client definition is to be saved. 4 


FALSE 
Indicates that the client definition is to be discarded. 
The default is TRUE. 


STATUS 
Returns the completion status of this subcommand. 


@ When the client application definition is to be saved, the definition is . 
checked for errors. The DEFINE_CLIENT subutility session does not 
end if errors are found. The subutility issues a message documenting 
the problem. (You can enter subcommands to correct the problem.) A 
definition in error is never saved. 


@ The client definition is recorded in the 
$SYSTEM.NETWORK.APPLICATION.DEFINITIONS file when this 
subcommand executes successfully. The definition remains in effect until 
explicitly deleted. 
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END_DEFINE_SERVER 


END _DEFINE_SERVER 
DEFS Subcommand 


Purpose Ends a DEFINE_SERVER subutility session. 


Format END _DEFINE_SERVER or 
ENDDS or 
QUIT or 
QUI 
SAVE _DEFINITION = boolean 
STATUS =status variable 


Parameters SAVE_DEFINITION or SD 
Specifies whether to save or discard the changes you have made to the 
server definition. ae ae 


TRUE 
Indicates that the server definition is to be saved. 


FALSE 
Indicates that the server definition is to be discarded. 
The default is TRUE. ee ree 


STATUS 


Returns the completion status of this subcommand. 


Remarks @ When the server application definition is to be saved, the definition is 
checked for errors. The DEFINE_SERVER subutility session does not 
end if errors are found. The subutility issues a message documenting 
the problem. (You can enter subcommands to correct the problem.) A 
definition in error is never saved. 


© The server definition is recorded in the 
$SYSTEM.NETWORK.APPLICATION.DEFINITIONS file when this 
subcommand executes successfully. The definition remains in effect until 
explicitly deleted. 
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GENERATE_APPLICATION_DEFINITION 


GENERATE _APPLICATION _ DEFINITION 
MANNA Subcommand 


Purpose Generates a set of MANNA subcommands that defines one or more 
existing client and server applications. You can reenter this set of 
subcommands in the MANNA utility to redefine the application. 


Format GENERATE_APPLICATION _ DEFINITION or 
GENAD 
APPLICATION =keyword or list of name 
OUTPUT =file 
STATUS =status variable 


Parameters APPLICATION or A 


Specifies the names of one or more applications for which application 
definitions are to be generated. The keyword ALL can be specified to 
generate the definitions of all applications. 


The default value is ALL. 


OUTPUT or O 


Specifies the file on which the generated definition subcommands are to be 
written. The default is $OUTPUT. 


STATUS 
Returns the completion status of this subcommand. 


- Remarks You must specify an output file in order to edit the definition. 
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GENERATE_CLIENT_DEFINITION 


GENERATE _CLIENT_DEFINITION 
MANNA, DEFC, and CHAC Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Generates a set of MANNA subcommands that defines one or more 
existing client applications. You can reenter this set of subcommands in 
the MANNA utility to redefine the client application. 


GENERATE_CLIENT_DEFINITION or 
GENCD 
CLIENT =keyword or list of name 
OUTPUT =file 
STATUS =status variable 


CLIENT or C 


Specifies the names of one or more client applications for which client 
application definitions are to be generated. The keyword ALL can be 
specified to generate the definitions of all client applications. 


The default value is ALL if used outside of the DEFINE_CLIENT or 
CHANGE_CLIENT subutility. When used inside of the DEFINE_CLIENT 
or CHANGE_CLIENT subutility, the client definition currently being 
defined or changed is the default. . 

OUTPUT or O 

Specifies the file on which the generated definition subcommands are to be 
written. The default is $OUTPUT. 

STATUS . 

Returns the completion status of this subcommand. 


You must specify an output file in order to edit the definition. 
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GENERATE_SERVER_DEFINITION 


GENERATE _SERVER_DEFINITION 
MANNA, DEFS, and CHAS Subcommand 


Purpose 


Format 


Parameters 


Generates a set of MANNA subcommands that defines one or more 
existing server applications. You can reenter this set of subcommands in 
the MANNA utility to redefine the server application. 


GENERATE_SERVER_DEFINITION or 
GENSD 
SERVER =keyword or list of name 
OUTPUT =file 
STATUS =status variable 


SERVER or S 


Specifies the names of one or more server applications for which server 
application definitions are to be generated. The keyword ALL can be 
specified to generate the definitions of all server applications. 

The default value is ALL if used outside of the DEFINE_SERVER or 
CHANGE_SERVER subutility. When used inside of the DEFINE_SERVER 
or CHANGE_SERVER subutility, the server application currently being 
defined or changed is the default. 


OUTPUT or O 
Specifies the file on which the generated definition pubcommands are to be 


written. The default is $OUTPUT. 


' Remarks 


Revision C 


STATUS 
Returns the completion status of this subcommand. 


You must specify an output file in order to edit the definition. 
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QUIT 


QUIT 
MANNA Subcommand 


Purpose Ends a MANNA utility session. 


Format QUIT or 
QUI 


Parameters None. 
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This chapter describes the NOS/VE commands used to manage the system-defined 
network applications. The one exception is the DEFINE. NETWORK command that 
defines the Timesharing application. The DEFINE_NETWORK command is described 
in the NOS/VE Software Release Bulletin. 


Generally, there are four commands/subcommands for each network application; one 
each to define, delete, activate, and deactivate the application. You can enter the 
define and delete subcommands from the MANAGE_ APPLICATION _ DEFINITIONS 
utility. These subcommands are described in alphabetical order following the 
MANAGE_APPLICATION_DEFINITIONS command. The activate and deactivate 
commands can be found later in this chapter in the Activate and Deactivate 
Commands section. 


To bring up any of the system-defined applications, the application must first be 
defined, then activated, using the appropriate commands described in this chapter. 
The commands that activate each application are typically placed in the network 
activation epilog file ((SYSTEM.PROLOGS_AND_EPILOGS.NETWORK_ 
ACTIVATION_EPILOG). The commands that define the applications are not placed in 
the network activation epilog file because the definitions of the applications are 
retained across deadstarts. The network activation epilog file is described in the 
NOS/VE System Performance and Maintenance manual, Volume 2. 


MANAGE _APPLICATION_DEFINITIONS Utility 


The MANAGE_APPLICATION_DEFINITIONS (MANAD) utility is an SCL command 
utility. It follows the rules for utilities given in the NOS/VE System Usage manual. 


Except for QUIT, all of the utility subcommands have an optional STATUS 
parameter. Information on using the STATUS parameter can be found in the NOS/VE 
System Usage manual. 
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MANAGE_APPLICATION_ DEFINITIONS 


MANAGE _APPLICATION _ DEFINITIONS 
Purpose Initiates a MANAGE_APPLICATION_ DEFINITIONS utility session. 


Format MANAGE_APPLICATION _DEFINITIONS or 
MANAD 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 
Remarks © To use this utility, you must be validated by the system 
administrator. For more information, refer to the NOS/VE User 
Validation manual. 
e This utility must be entered at the NOS/VE system console. 
@ The prompt for the MANAD utility is: 


mad/ 
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DEFINE_BTF 


DEFINE_BTF 


Purpose Defines the Batch Transfer Facility/VE (BTF/VE) network client 
application. 


Format DEFINE _BTF 
STATUS =status variable 
Parameters STATUS | 
Returns the completion status of this subcommand. 


Remarks @ The name of the client application created is OSA$BATCH— 
TRANSFER_CLIENT. 


© The system task for BTF is activated by the SCF system task as an 
asynchronous task whenever output is transferred to an active batch 
device, or by the NTF system task as an asynchronous task whenever 
a file is transferred to an active batch stream. 
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DEFINE_BTFS 


DEFINE _BTFS 
Purpose Defines the Batch Transfer Facility Server/VE (BTFS/VE) network 
application. 


Format DEFINE_BTFS 
FAMILY_ NAME =list of names 
STATUS =siatus variable 

Parameters FAMILY NAME or FAMILY_NAMES or FN 


Defines all families on this mainframe that can be accessed by batch 
input. Up to 26 family names can be specified. This is a required 
parameter. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the server application created is OSA$BATCH_TRANSFER_ 
SERVER. 
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DEFINE_DESKTOP_ENVIRONMENT 


DEFINE_DESKTOP_ENVIRONMENT 


Purpose 


Format 


Parameters 


Remarks 


Revision D 


Defines the Desktop/VE network client application. 


DEFINE_DESKTOP_ENVIRONMENT 
STATUS =status variable 


STATUS 
Returns the completion status of this subcommand. 


The name of the client application created is DESKTOP_VE. 
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DEFINE_FTP 


DEFINE _FTP 


Purpose Defines the File Transfer Protocol (FTP) network client application. 


Format DEFINE _FTP 
STATUS =status variable 


Parameters STATUS 


Returns the completion status of this subcommand. 


Remarks The name of the client application created is OSA$FTP_CLIENT. 
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DEFINE_FTPS 


DEFINE _FTPS 
Purpose Defines the File Transfer Protocol Server (FTPS) network application. 
Format DEFINE_FTPS 


STATUS =status variable 


Parameters STATUS 
Returns the completion status of this subcommand. 


Remarks @ The name of the network application created is OSA$FTP_SERVER. 


e Although this application operates as a server application, it is 
defined as a client application. See appendix C for more information 
about defining the File Transfer Protocol applications. 
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DEFINE_IPC_APPLICATIONS 


DEFINE_IPC_APPLICATIONS 
Purpose Defines the Interprocess Communication (IPC) network client application. 


Format DEFINE_IPC_APPLICATIONS 
STATUS =status variable 


Parameters STATUS 


Returns the completion status of this subcommand. 


Remarks e The name of the client application created is OSA$IPC_ 
APPLICATIONS. 


@ The IPC client application is made up of the following server 
applications: 


- NFS/VE, which contains the bulk of Control Data’s implementation 
of NFS. 


- Portmapper, which maps calls from client systems into registered 
server calls. 


~- PCNFSD, which allows PCs running PC-NFS to be validated to 
use NFS/VE. 
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DEFINE_NTF 


DEFINE _NTF 
Purpose Defines the Network Transfer Facility (NTF) network client application. 


Format DEFINE _NTF 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application created is OSA$NETWORK_ 
TRANSFER_FAC_CLIENT. 
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DEFINE_OPENTF 


DEFINE_OPENTF 
Purpose Defines the Operate NTF (OPENTF) network client application. 


Format DEFINE._OPENTF 
STATUS =status variable 


Parameters STATUS 


Returns the completion status of this subcommand. 
Remarks © The name of the client application created is OSA$NTF_OPERATOR. 


@ The Operate NTF (OPENTF) application is initiated by a user that is 
validated for this privilege. 
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DEFINE_OPES 


DEFINE_OPES 
Purpose —s-— Defines the OPERATE_STATION utility (OPES). network client application. | 


Format DEFINE_OPES 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this subcommand. 


Remarks @ The name of the client application created is OSA$STATION_ 
OPERATOR. 


@ The OPERATE_STATION utility is initiated by a user that is 
validated for this privilege. 
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DEFINE_PTF 


DEFINE _PTF 

Purpose Defines the Permanent File Transfer Facility (PTF) client and server 
applications. 

Format DEFINE _PTF 


FAMILY_NAME=list of names 
STATUS =status variable 


Parameters FAMILY_NAME or FAMILY_NAMES or FN 


Defines all families on this mainframe that can be accessed by PTF. Up 
to 26 family names can be specified. This is a required parameter. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the server application created is OSA$FILE_TRANSFER_ 
SERVER. The name of the client application created is OSA$FILE_ 
TRANSFER_CLIENT. 
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DEFINE_QTF 


DEFINE _QTF 
Purpose Defines the NAM/VE Queue File Transfer Facility (QTF) client application. 


Format DEFINE _QTF 
STATUS =siatus variable 


Parameters STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the NAM/VE QTF client application created is 
OSA$QUEUE_TRANSFER_ CLIENT. 
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DEFINE_QTFS 


DEFINE _QTFS 
Purpose Defines the NAM/VE Queue File Transfer Facility Server (QTFS) 
application. 


Format DEFINE _QTFS 
FAMILY_NAME=list of names 
STATUS =status variable 


Parameters FAMILY _NAME or FAMILY_NAMES or FN 


Defines all families that can be accessed by QTF. Up to 26 family names 
can be specified. This parameter is required. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the NAM/VE QTF server application created is 
OSAS$QUEUE_TRANSFER_SERVER. 
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DEFINE_SCF 


DEFINE_SCF 


Purpose 


Format 


Parameters 


Remarks 


Revision D 


Defines the Status and Control Facility/VE (SCF/VE) network client 
application. 


DEFINE _SCF 
STATUS =status variable 


STATUS 
Returns the completion status of this subcommand. 


The name of the client application created is OSA$STATUS_CONTROL_ 


FAC_CLIENT. 
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DEFINE_SCFS 


DEFINE_SCFS 
’ Purpose Defines the Status and Control Facility Server/VE (SCFS/VE) network 
application. 
Format DEFINE _SCFS 


APPLICATION _NAME =name 
STATUS =status variable 


Parameters APPLICATION_NAME or AN 


Specifies the SCF server application name. The default name is 
OSA$STATUS_CONTROL_ FAC_ SERVER. 


STATUS 


Returns the completion status of this subcommand. 
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DEFINE_SMTP 


DEFINE _SMTP 
' Purpose Defines the Simple Mail Transfer Protocol (SMTP) network client 
application. . 


Format DEFINE _SMTP 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application created is OSA$SMTP_CLIENT. 
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DEFINE_SMTPS 


DEFINE_SMTPS 
Purpose Defines the Simple Mail Transfer Protocol (SMTP) network server 
application. 


Format DEFINE_SMTPS 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this subcommand. 


Remarks ® The name of the network application created is OSA$SMTP_SERVER. 
@ Although this application operates as a server application, it is 


defined as a client application. See appendix C for more information 
about defining the Simple Mail Transfer Protocol applications. 
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DELETE_BTF 


DELETE _BTF 


Purpose Deletes the definition of the Batch Transfer Facility/VE (BTF/VE) network 
client application. 


Format DELETE_BTF 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 
Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 
Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 
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DELETE_BTFS 


DELETE _BTFS 


Purpose Deletes the definition of the Batch Transfer Facility Server/VE (BTFS/VE) 
network application. 


NOTE 


Before deleting the BTFS application definition, you must deactivate the 
associated system task using the DEACTIVATE_BTFS command at the 
system console. 


Format DELETE _BTFS 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the server application deleted is OSA$BATCH_TRANSFER_. 
SERVER. 
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DELETE_DESKTOP_ENVIRONMENT 


DELETE _DESKTOP_ENVIRONMENT 


Purpose 


Format 


Parameters 


Remarks 


Revision D 


Deletes the definition of the Desktop/VE network client application. 


DELETE _ DESKTOP_ENVIRONMENT 
TERMINATE _ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 


TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


The name of the network client application deleted is DESKTOP_VE. 
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DELETE_FTP| 


DELETE _FTP 
Purpose Deletes the definition of the File Transfer Protocol (FTP) network client 
application. ; 


Format DELETE _ FTP . 
TERMINATE_ACTIVE..CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application deleted is OSA$FTP_CLIENT. 
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DELETE_FTPS 


DELETE _FTPS 
Purpose. Deletes the definition of the File Transfer Protocol Server (FTPS) 
application. 


Format _DELETE_FTPS 
TERMINATE_ACTIVE_ CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks @ The name of the application deleted is OSA$FTP_ SERVER. 


© Although this application operates as a server application, it is 
defined as a client application. See appendix C for more information 
about defining the File Transfer Protocol applications. 
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DELETE_IPC_APPLICATIONS 


DELETE _IPC_APPLICATIONS 


Purpose Deletes the Interprocess Communication (IPC) network client application. 


Format DELETE _IPC_APPLICATIONS 
STATUS =status variable 


Parameters S TATUS 


Returns the completion status of this subcommand. 


Remarks The name of the client application deleted is OSA$IPC_ APPLICATIONS. 
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DELETE_NTF 


DELETE _NTF 


Purpose Deletes the definition of the Network Transfer Facility (NTF) network 
client application. | 


NOTE 


Before deleting the NTF application definition, you must deactivate the 
associated system task using the DEACTIVATE_NTF command at the 
system console. 


Format DELETE_NTF 
TERMINATE_ACTIVE__CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE | 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application deleted is OSASNETWORK_ 
TRANSFER_FAC_CLIENT. 
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DELETE_OPENTF 


DELETE_OPENTF 
Purpose Deletes the definition of the Operate NTF (OPENTF) network client 
application. 


Format DELETE _OPENTF 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application deleted is OSA$NTF_OPERATOR. 
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DELETE_OPES 


DELETE _OPES 


Purpose 


Format 


Parameters 


Remarks 


Revision D 


Deletes the definition of the OPERATE_STATION utility (OPES) network 
client application. 


DELETE_OPES 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 

TERMINATE _ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE — 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. . 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


The name of the client application deleted is OSA$STATION_ OPERATOR. 


Application Installation Commands 5-27 


DELETE_PTF 


DELETE _PTF 


Purpose Deletes the definition of the Permanent File Transfer Facility (PTF) 
network client and server applications. 


Format DELETE _PTF 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 
Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 
Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 
TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application deleted is OSA$FILE_TRANSFER_ 
CLIENT. The name of the server application deleted is OSA$FILE_ 
TRANSFER_SERVER. 
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DELETE_QTF 


DELETE _QTF 


Purpose Deletes the definition of the NAM/VE Queue File Transfer Facility (QTF) 
client application. 


Format DELETE _QTF 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 

Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the NAM/VE QTF client application deleted is OSASQUEUE_ 
TRANSFER_CLIENT. 
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DELETE_QTFS 


DELETE _QTFS 


Purpose Deletes the definition of the NAM/VE Queue File Transfer Facility Server 
(QTFS) application. 


Format — DELETE_QTFS 
TERMINATE_ACTIVE_.CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the NAM/VE QTF server application deleted is 
OSAS$QUEUE_TRANSFER_SERVER. 
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DELETE_SCF 


DELETE _SCF 


Purpose Deletes the definition of the Status and Control eee sie (SCF/VE) | 
network client application. 


NOTE 


If the DELETE_SCF subcommand executes before the DEACTIVATE_ 
SCF command executes, the system task terminates but is still defined. 


Format DELETE _SCF 
TERMINATE_ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application deleted is OSA$STATUS_CONTROL_ 
FAC_CLIENT. 
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DELETE_SCFS 


DELETE _SCFS 


Purpose Deletes the definition of the Status and Control Facility Server/VE 
(SCFS/VE) network application. 


NOTE 


If the DELETE_SCFS subcommand executes before the DEACTIVATE_ 
SCFS command executes, the system task terminates but is still defined. 


Format DELETE_SCFS 
APPLICATION_.NAME = name 
TERMINATE _ACTIVE_CONNECTIONS = boolean 
STATUS =status variable 
Parameters APPLICATION_NAME or AN 
Specifies the SCF server application that is to be deleted. The default 
application name is OSA$STATUS..CONTROL_FAC_SERVER. 
TERMINATE_ACTIVE_CONNECTIONS or TAC 
Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 
TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the client application deleted is OSA$STATUS_CONTROL_ 
FAC_SERVER. 
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DELETE_SMTP 


DELETE_SMTP 


Purpose Deletes the definition of the Simple Mail Transfer Protocol (SMTP) network 
client application. 


Format DELETE_SMTP 
TERMINATE_ACTIVE _CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC | 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS 
Returns the completion status of this subcommand. 


Remarks The name of the application deleted is OSA$SMTP_CLIENT. 
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DELETE_SMTPS 


DELETE_SMTPS 
Purpose Deletes the definition of the Simple Mail Transfer Protocol (SMTP) server 
application. 


Format DELETE_SMTPS 
TERMINATE_ACTIVE _CONNECTIONS = boolean 
STATUS =status variable 


Parameters TERMINATE_ACTIVE_CONNECTIONS or TAC 


Specifies whether to terminate active connections immediately or allow 
them to terminate normally. 


TRUE 
Indicates that active connections are to be terminated immediately. 


FALSE 


Indicates that active connections are to be allowed to continue until 
they terminate normally. 


The default value is FALSE. 


STATUS | 
Returns the completion status of this subcommand. 


Remarks @ The name of the application deleted is OSA$SMTP_SERVER. 


e Although this application operates as a server application, it is 
defined as a client application. See appendix C for more information 
about defining the Simple Mail Transfer Protocol applications. 
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QUIT 


QUIT 
Purpose Ends a MANAGE_ APPLICATION DEFINITIONS utility session. 


Format QUIT or 
QUI 


Parameters None. 
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Activate and Deactivate Commands 


Activate and Deactivate Commands 


The commands that activate each application are typically placed in the network 
activation epilog file $SYSTEM.PROLOGS_AND_EPILOGS.NETWORK _ ACTIVATION _ 
EPILOG. If it is necessary to deactivate an application, this can be done by using the | 
appropriate deactivate command. The application can then be reactivated using the 
corresponding activate command. The activate and deactivate commands must be 
entered at the NOS/VE system console. 
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ACTIVATE_BTFS 


ACTIVATE _BTFS 


Purpose Defines and activates a system task for the Batch Transfer Facility 
Server/VE (BTFS/VE) application. If the BTFS system task definition 
already exists when this command is entered, that task definition is 
removed before a new task is defined and activated. 


Format ACTIVATE _BTFS 
LOAD_ MAP =file 
STATUS =status variable 
Parameters LOAD_MAP or LM 


Specifies a file to which the load map should be written. The default file 
name is $NULL. | 


STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system task created by this command is BTF_ 
SERVER. . . 


@ This command should be entered only once after deadstart. If it is 


“necessary to enter a DEACTIVATE_BTFS command, then this 
command may be entered to reactivate the BTF server application. 
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ACTIVATE_INETD 


ACTIVATE _INETD 
Purpose Activates a system task for the Internet Daemon (INETD) server © 
application. 


Format ACTIVATE _INETD 
TRACE_MODE = boolean 
STATUS =sitatus variable 
Parameters TRACE_MODE or TM 
Specifies whether to log tracing information. 


TRUE 
The INETD server application creates a file and logs tracing 
information to it. The file name is :$SYSTEM.$SYSTEM.TCP_ 
IP INETD_TRACE_FILE_ OUTPUT.$NEXT. 
FALSE 
Tracing information is not logged. 

The default value is FALSE. 


STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system task created by this command is 
INTERNET_DAEMON. 


e This command should be entered only once after deadstart. If it is 


necessary to enter a DEACTIVATE_INETD command, then this 
command may be entered to reactivate the INETD server application. 
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ACTIVATE_NETWORK 


ACTIVATE _NETWORK 


Purpose 


Format 


- Parameters 


Remarks 


-Revision D . 


Activates NAM/VE and executes the network activation prolog and epilog 
files (SSYSTEM.PROLOGS_ AND_EPILOGS.NETWORK_ ACTIVATION _ 
PROLOG and $SYSTEM.PROLOGS_ AND_EPILOGS.NETWORK_ 
ACTIVATION_EPILOG) to activate the network tasks. 


ACTIVATE _NETWORK or 
ACTN 
_ STATUS =status variable 
STATUS 
Returns the completion status of this command: 


® If the NETWORK ACTIVATION system attribute is set to 1 (the 
default value), the ACTIVATE. NETWORK command is executed 


automatically during deadstart. The NETWORK_ ACTIVATION 
attribute is described in the NOS/VE System Performance and 
Maintenance manual, Volume 2. 


If the NETWORK_ACTIVATION parameter for the ACTIVATE_ 
PRODUCTION_ ENVIRONMENT command is TRUE (the default 
value), the ACTIVATE. NETWORK command is executed by the 
ACTIVATE. PRODUCTION_ENVIRONMENT command. The 
ACTIVATE_ PRODUCTION_ ENVIRONMENT command is described 
in the NOS/VE Operations manual. 


Once NAM/VE has been activated, the ACTIVATE. NETWORK 
command only executes the network activation epilog file. 
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ACTIVATE_NFS 


ACTIVATE __NFS 


Purpose Activates a system job for the Network File System on NOS/VE (NFS/VE) 
server application. 


Format ACTIVATE _NFS 


DEBUG = boolean 
STATUS =status variable 


Parameters DEBUG or D 
Specifies whether to turn on debugging code. 


TRUE 


Debugging messages are written to the $SYSTEM.NFS.NFS_TASK_ 
LOG and §SYSTEM.NFS.NFS_LOG files. 


FALSE 


Debugging code remains off. 


The default value is FALSE. 


STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system job created by this command is NFS_ 


DAEMON. 


This command should be entered only once after deadstart. If it is 
necessary to enter a DEACTIVATE_NFS command, then this 
command may be entered to reactivate the NFS/VE server application. 


Although this application operates as a server application, it is 
considered an IPC application which must be defined as a client 
application. See appendix C for more information about defining the 
IPC applications. 


The Portmapper server application must be activated with the 
ACTIVATE._.PORTMAP command before the NFS/VE server 
application can be activated. 
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ACTIVATE_NTF 


ACTIVATE _NTF 


Purpose Defines and activates a system task for the Network Transfer Facility 
(NTF) client application. If the NTF system task definition already exists 
when this command is entered, that task definition is removed before a 
new task is defined and activated. 


Format - ACTIVATE_NTF 
AUTOMATIC_STATION _NAME= name 
ACTIVATE_NTF_ MAIL = boolean 
LOAD_ MAP =file 
STATUS =status variable 
Parameters AUTOMATIC_STATION_NAME or ASN 


Specifies the control facility name that should be used when you specify 
AUTOMATIC as the STATION parameter of the PRINT_FILE or 
SUBMIT_JOB command with a destination usage of NTF. This parameter 
is required. 

ACTIVATE_NTF_MAIL or ANM 


Specifies whether the NTF mail system task should be initiated at the 
same time as the NTF system task. 


TRUE 


If you specify TRUE and Mail/VE can process BITNET mail, the 
ACTIVATE_NTF command automatically issues the following 
command: 


ACTIVATE_NTF_MAIL CONTROL_FACILITY_NAME=name 


where name is the same control facility name that is specified for the 
AUTOMATIC_STATION_NAME parameter. 


FALSE 


If you specify FALSE or Mail/VE cannot process BITNET mail, the 
NTF mail system task is not initiated. 


‘The default value is TRUE. 


LOAD_MAP or LM 


Specifies a file to receive load map information from the system task. If 
the LOAD. MAP parameter is omitted, no load map information is 
written. 


STATUS 
Returns the completion status of this command. 
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ACTIVATE_NTF 


Remarks @ The name of the system task created by this command is NTF_ 
CLIENT. 


® This command should be entered only once after deadstart. If it is 
necessary to deactivate NTF using the DEACTIVATE_NTF command, 
then this command may be entered to reactivate the NTF client 
application. 


® The ACTIVATE_NTF command defines and activates the system task 
for NTF. The NTF system task activates the BTF system task as an 
asynchronous task whenever a file is transferred to an active batch 
stream. 


® The ACTIVATE_NTF command must be issued on each NOS/VE 
machine that is to send files to remote systems through NTF. 


@ The ACTIVATE_NTF command should be placed in the network 
activation epilog file (SSYSTEM.PROLOGS_AND_ 
EPILOGS.NETWORK_ACTIVATION._EPILOG) for automatic 
activation across deadstarts. The network activation epilog file is 
described in the NOS/VE System Performance and Maintenance 
manual, Volume 2. 


Examples In this example, both the NTF system task and the NTF mail system task 
are initiated. NTF expects remote seston to be controlled by control 
facility NTF_CONTROL_ FAC. 


/activate_ntf asn=ntf_control_fac anm=true 
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ACTIVATE_NTF_MAIL 


ACTIVATE _NTF_MAIL 


Purpose 


Format 


Parameters 


Remarks 


Examples 


Revision D 


Defines and activates the Network Transfer Facility (NTF) mail system 
task that enables BITNET class M mail to be sent and received by 


. Mail/VE Version 1. 


ACTIVATE _NTF_MAIL 
CONTROL_FACILITY_NAME= name 
LOAD_ MAP =file 
STATUS =status variable 


CONTROL_ FACILITY_NAME or CFN 


Specifies the name of the control facility that controls the NTF remote 
systems that can receive letters from Mail/VE Version 1. This paramter 
is required. 


LOAD_ MAP or LM 


Specifies a file to receive load map information from the system task. If 
the LOAD_MAP parameter is omitted, no load map information is 
written. 


STATUS 
Returns the completion status of this command. 


@ The name of the system task created by this command is NTF_ 
"MAIL_CLIENT. 


@ The ACTIVATE_NTF_MAIL command is issued automatically when 
the ACTIVATE_NTF command is specified with the ACTIVATE_ 
NTF_MAIL parameter set to TRUE. For this special case, the control 
facility name for the ACTIVATE_NTF_MAIL command is the same 
as the control facility name specified in the AUTOMATIC_STATION_ 
NAME parameter for the ACTIVATE_NTF command. 


In this example, the NTF mail system task is not activated by the 
ACTIVATE_NTF command. Also, the NTF mail system task is activated 
with a control facility name that is different than the automatic station 
name for NTF. 


/activate_ntf asn=ntf_control_fac anm=false 
/activate_ntf_mail cfn=ntf_bitnet 
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ACTIVATE_PCNFSD 


ACTIVATE _PCNFSD 


Purpose 


: Format 


Parameters 


Remarks 


Activates a system job for the PC Network File System (PCNFSD) server 
application. 


ACTIVATE _PCNFSD 
FAMILY = name 
DEBUG = boolean 
STATUS =status variable 


FAMILY or F 


Specifies the name of the family that PCs running PC-NFS can access. 
This parameter is required. 


DEBUG or D 
Specifies whether to turn on debugging code. 


TRUE 


Debugging messages are written to the $SYSTEM.NFS.PCNFSD_ 
TASK_LOG and $SYSTEM.NFS.PCNFSD_LOG files. 


FALSE 
Debugging code remains off. 
The default value is FALSE. 


STATUS 
Returns the completion status of this command. 


e The name of the system job created by this command is PCNFS_ 
DAEMON. 


e This command should be entered only once after deadstart. If it is 
necessary to enter a DEACTIVATE_PCNFSD command, then this 
command may be entered to reactivate the PCNFSD server 
application. 


e@ Although this application operates as a server application, it is 
considered an IPC application which must be defined as a client 
application. See appendix C for more information about defining the 
IPC applications. 


© The Portmapper server application must be activated with the 
ACTIVATE_PORTMAP command before the PCNFSD server 
application can be activated. 


@ The Portmapper, NFS/VE, and PCNFSD server applications must be 
activated before a PC can use PC-NFS to access the CYBER file 
system. 


e PCNFSD is limited to one family per CYBER mainframe. 
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ACTIVATE_PORTMAP 


ACTIVATE _PORTMAP 
Purpose Activates a system job for the Portmapper server application. 


Format ACTIVATE _PORTMAP 
DEBUG =boolean 
STATUS =status variable 


Parameters DEBUG or D 
Specifies whether to turn on debugging code. 


TRUE 


Debugging messages are written to the 
$SYSTEM.NFS.PORTMAPPER_TASK_ LOG and 
$SYSTEM.NFS.PORTMAPPER_LOG files. 


FALSE 
Debugging code remains off. 
The default value is FALSE. 


STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system job created by this command is PORTMAP_ 
DAEMON. 


© This command should be entered only once after deadstart. If it is 
necessary to enter a DEACTIVATE_PORTMAP command, then this 
command may be entered to reactivate the PORTMAPPER server 
application. 


e Although this application operates as a server application, it is 
considered an IPC application which must be defined as a client 
application. See appendix C for more information about defining the 
IPC applications. 


@ The Portmapper server application must be activated with the 
ACTIVATE..PORTMAP command before the NFS/VE or .PCNFSD 
server applications can be activated. 
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ACTIVATE_PTF 


ACTIVATE _PTF 


Purpose Defines and activates a system task for the Permanent File Transfer 
Facility (PTF) server application. If the PTF system task definition already 
exists when this command is entered, that task definition is removed 
before a new task is defined and activated. 


Format ACTIVATE _ PTF 
LOAD_ MAP =file 
STATUS =status variable 
Parameters JLOAD_MAP or LM 
Specifies a file to which the load map should be written. The default file 


name is $NULL. 
STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system task created by this command is OSA$FILE_ 
TRANSFER_SERVER. 


@ This command should be entered only once after deadstart. If it is 
necessary to deactivate PTF using the DEACTIVATE_PTF command, 
then this command may be entered to reactivate the PTF server 
application. 
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ACTIVATE_QTF 


ACTIVATE _QTF 


Purpose Defines and activates a system task for the Queue File Transfer Facility 
(QTF) client application. If the QTF system task definition already exists 
when this command is entered, that task definition is removed before a 
new task is defined and activated. 


Format ACTIVATE _QTF 
HOST_PHYSICAL_IDENTIFIER= string 
MAXIMUM _SUBTASKS =keyword or integer 
LOAD_ MAP =file 
STATUS =status variable 


Parameters HOST_PHYSICAL_IDENTIFIER or HPI 


Specifies the physical identifier of the local host mainframe. The value 
specified can be a string of up to 31 characters. This parameter is 
required. 


MAXIMUM_SUBTASKS or MS 


Specifies the maxium number of QTF subtasks that may be active at one 
time. The value specified can be an integer from 1 to 20 or the keyword 
UNLIMITED. The default value is UNLIMITED. 


LOAD_MAP or LM 


Specifies a file to which the load map should be written. The default file 
name is $NULL. 


STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system task created by this command is QUEUE_ 
TRANSFER_CLIENT. 


@ This command should be entered only once after deadstart. If it is 
necessary to enter a DEACTIVATE_QTF command, then this 
command may be entered to reactivate the QTF client application. 


e The HOST_PHYSICAL_IDENTIFIER parameter is used when QTF 
uses NAM/VE to transfer a file. If LCN is used, the physical 
identifier of the host is obtained by the application. The host physical 
identifier specified when activating QTF should be the same as the 
one specified when activating QTFS. 
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ACTIVATE_QTFS 


ACTIVATE _QTFS 


Purpose 


Format 


Parameters 


Remarks 


Defines and activates a system task for the Queue File Transfer Facility 
Server (QTFS) application. If the QTFS system task definition already 
exists when this command is entered, that task definition is removed 
before a new task is defined and activated. 


ACTIVATE_QTFS 
HOST_PHYSICAL_IDENTIFIER = string 
LOAD MAP =file 
STATUS =status variable 


HOST_PHYSICAL_IDENTIFIER or HPI 


Specifies the physical identifier of the local host mainframe. The value 
specified can be a string of up to 31 characters. This parameter is 
required. 


LOAD_MAP or LM 


Specifies a file to which the load map should be written. The default file 
name is $NULL. 


STATUS 
Returns the completion status of this command. 


@ The name of the system task created by this command is QUEUE_ 
TRANSFER_SERVER. 


@ This command should be entered only once after deadstart. If it is 
necessary to enter a DEACTIVATE_QTFS command, then this 
command may be entered to reactivate the QTF server application. 


e The HOST_PHYSICAL_IDENTIFIER parameter is used when QTFS 
uses NAM/VE to transfer a file. If LCN is used, the physical 
identifier of the host is obtained by the application. The host physical 
identifier specified when activating QTFS should be the same as the 
one specified when activating QTF. 
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ACTIVATE_SCF 


ACTIVATE _SCF 


Purpose 


Format 


Parameters 


Remarks 


Revision D 


Defines and activates a system task for the Status and Control Facility/VE 
(SCF/VE) client application. If the SCF system task definition already 
exists when this command is entered, that task definition is removed 
before a new task is defined and activated. 


ACTIVATE _SCF 
LOAD_ MAP =file 
STATUS =status variable 


LOAD_MAP or LM 


Specifies a file to which the load map should be written. The default file 
name is $NULL. 


STATUS 
Returns the completion status of this command. 


@ The name of the system task created by this command is SCF_ 
CLIENT. 


@® This command should be entered only once after deadstart. If it is 
necessary to enter a DEACTIVATE_SCF command, then this 
command may be entered to reactivate the SCF client application. 


@ The ACTIVATE_SCF command defines and activates the system task 
for SCF. The SCF system task activates the BTF system task as an 
asynchronous task whenever output is transferred to an active batch 
device. 


Application Installation Commands 5-49 


ACTIVATE_SCFS 


ACTIVATE _SCFS 


Purpose 


Format 


Parameters 


Defines and activates a system task for the Status and Control Facility 
Server/VE (SCFS/VE) application. If the SCFS system task definition 
already exists when this command is entered, that task definition is 
removed before a new task is defined and activated. 


ACTIVATE _SCFS 
APPLICATION ..NAME =name 
CONTROL... FACILITY_NAME =name 
SYSTEM_TASK_NAME =name 
LOAD_ MAP =file 
LOGGING = boolean 
NTF_SYSTEM_ LIST = file 
STATUS =status variable 


APPLICATION_NAME or AN 

Specifies the name of the SCFS application (as defined previously on the 
DEFINE_SCFS command). The default name is OSA$STATUS_ 
CONTROL_FAC_SERVER. See Remarks for further restrictions on the 
use of this parameter. 

CONTROL._FACILITY_NAME or CFN 

Specifies a name for the control facility. The default name is STATION _ 
CONTROLLER_1. See Remarks for further restrictions on the use of this 
parameter. 

SYSTEM_TASK_NAME or STN 

Specifies the name of the system task. The default name is SCF_ 
SERVER. See Remarks for further restrictions on the use of this 
parameter. 

LOAD_MAP or LM 

Specifies a file to which the load map should be written. The default file 
name is $NULL. 

LOGGING or L 

Specifies whether or not to log SCF server events. 


TRUE 
SCF server events are logged. 


FALSE 
SCF server events are not logged. 
The default value is FALSE. 


NTF_SYSTEM_LIST or NSL 


Specifies the file in which the remote system names used by NTF are 
stored. This is an optional parameter that must be specified if NTF is to 
be run in conjunction with this SCFS application. If it is not specified, 
this SCFS application will not control NTF remote systems. 


STATUS 
Returns the completion status of this command. 
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Remarks 


Revision D 


ACTIVATE_SCFS 


The default name of the system task is SCF_SERVER. 


This command should be entered only once after deadstart. If it is 
necessary to enter a DEACTIVATE_SCFS command, then this 
command may be entered to reactivate the SCF server application. 


The parameters APPLICATION..NAME, CONTROL_FACILITY_ 
NAME, and SYSTEM_TASK_NAME can be used only in one of the 
following combinations: 


- Specify none of the parameters and allow the defaults to be used. 


- Specify all three parameters by entering values other than the 
default values. 


- Specify only the parameter APPLICATION_NAME by entering a 
value other than the default value. In this case, the name 
specified for APPLICATION_NAME will also be used for the 
CONTROL_FACILITY_NAME and SYSTEM_TASK_ NAME 
parameters. 


The file $$sYSTEM.CDCNET.SITE_ CONTROLLED. 
PROCEDURES.TERMINAL is a file of command procedures. 
Procedures on this file may contain commands for DEFINE_I_O_ 
STATION and DEFINE_USER_I_O_STATION. Each of these 
commands has a CONTROL_FACILITY parameter. In order for the 
I/O stations to communicate with the NOS/VE SCF server, the value 
specified for this parameter on both commands must match the value 
of the CONTROL_FACILITY_NAME parameter of the ACTIVATE_ 
SCFS command. 


The SCFS logging capability (controlled by the logging parameter) is 
normally used only for debugging purposes. It is recommended that 
the SCFS log be enabled only when advised to do so by a Control 
Data customer engineer or analyst. If the SCF logging capability is 
enabled, a binary log file is created in catalog $SYSTEM.BATCH_ 
DEVICE_SUPPORT.SCFS_LOG. The name of the binary log is the 
same as the control facility name. 


Multiple copies of the SCFS system task can be resident in a NOS/VE 
system or in the catenet. If additional copies are needed, they can be 
defined with unique system task names (if in the same NOS/VE 
system) at any time. 


If SCFS is defined more than once in a catenet, unique names must 
be used for the control facility names. Unique names must also be 
used for application names and system task names defined within: the 
same NOS/VE system. This means that the default name for the 
SCFS server application can be used only once in a given network. 


Be sure that all I.O_STATION_NAMES (IOSN parameter on the 
DEFIOS TDP commands) in the catenet differ from the control facility 
names. Like the name for the control facility (or the Timesharing 
application title), each IOSN is a title to be registered in the catenet. 


If SCFS is to be run in association with the Network Transfer 
Facility (NTF), the NTF_SYSTEM_LIST parameter must specify the 
file in which the remote system names used by NTF are stored. 
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ACTIVATE_SMTP 


Purpose 


Format 


Parameters 


Defines and activates a system task for the Simple Mail Transfer Protocol 
(SMTP) client application. If the SMTP system task already exists when 
this command is entered, that task definition is removed before a new task 
is defined and activated. . 


- ACTIVATE_SMTP 


DEBUG_MODE = boolean 

LOAD_ MAP =file 

MAXIMUM_QUEUED_ TIME =keyword or integer 
MAXIMUM _SUBTASKS = integer 
PROCESS_INTERVAL = integer 
RETRANSMISSION _INTERVAL = integer 
STATUS =status variable 


DEGUG_MODE or DM 
Specifies whether to turn on debugging code. 


TRUE 
Debugging messages are written to the system job log. 


FALSE 
Debugging code remains off. 
The default value is FALSE. 


LOAD_MAP or LM 


Specifies a file to which the load map should be written. The default file 
is $NULL. 


MAXIMUM _QUEUED_TIME or MQT 


Specifies the maximum time interval in minutes that a message can stay 
in the SMTP mail queue to wait for retransmission. The message is 
deleted when the specified time has elapsed. Specify an integer in the 
range from 0 to 65,535 or the keyword INFINITE. If 0 is specified, a 
message is not queued for a later retry; it is deleted and the system 
operator is notified. If INFINITE is specified, the message stays in the 
queue until it is either delivered or deleted from the queue by the 
system operator by way of a queue file management command. The 
default value is 60. 


MAXIMUM_SUBTASKES or MS 


Specifies the maximum number of concurrent mail delivery tasks that 
can be active at one time. Specify an integer in the range from 1 to 20. 
This parameter allows a site to keep the SMTP client from using 
excessive system resources for mail deliveries. The default value is 10. 
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Remarks 


Revision D 


ACTIVATE_SMTP 


PROCESS_INTERVAL or PI 


Specifies the time interval in minutes to poll the SMTP mail queue for 
newly arrived messages to process. Specify an integer in the range from 
0 to 60. If 0 is specified, a message is processed as soon as it is placed 
in the SMTP mail queue. A maximum value is imposed in order to 
prevent excessive build up of SMTP mail messages in the mail queue. 
The default value is 5. 


RETRANSMISSION_INTERVAL or RI 

Specifies the time interval in minutes to initiate retransmission of 
previously undeliverable mail messages in the SMTP mail queue. Specify 
an integer in the range from 5 to 60. The default value is 15. 

STATUS 

Returns the completion status of the command. 


© The name of the system task created by this command is SMTP_ 
CLIENT. 


© This command should be entered only once after deadstart. If it is 


necessary to enter a DEACTIVATE_ SMTP command, then this 
command may be entered to reactivate the SMTP client application. 
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DEACTIVATE _BTFS 


Purpose Deactivates and removes the system task for the Batch Transfer Facility 
Server/VE (BTFS/VE) application. 


Format DEACTIVATE_BTFS 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks ® The name of the system task deactivated and removed by this 
command is BTF_SERVER. 


e After the BTF server is deactivated by this command, the 


ACTIVATE BTFS command can be used to reactivate the BTF server 
application. 


5-54 Network Management Revision D 


DEACTIVATE_INETD 


DEACTIVATE _INETD 
Purpose ‘Deactivates the system task for the Internet Daemon (INETD) server 
application. 


Format |§DEACTIVATE_INETD 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks e The name of the system task deactivated by this command is 
INTERNET_DAEMON. 


e After the INETD server is deactivated by this command, the 
ACTIVATE_INETD command can be used to reactivate the INETD 
server application. 
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DEACTIVATE_NFS 


DEACTIVATE _NFS 


Purpose Deactivates and removes the system job for the Network File System on 
NOS/VE (NFS/VE) server application. 


Format DEACTIVATE_NFS 
STATUS =status variable 


Parameters STATUS 


Returns the completion status of this command. 


Remarks © The name of the system job deactivated and removed by this 
command is NFS_DAEMON. 


© After the NFS/VE server is deactivated by this command, the 


ACTIVATE_NFS command can be used to reactivate the NFS/VE 
server application. 
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DEACTIVATE_NTF 


DEACTIVATE __NTF 


Purpose Deactivates and removes the system task for the Network Transfer Facility 
(NTF) client application. 


Format DEACTIVATE _NTF 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks © The name of the system task deactivated and removed by this 
command is NTF_CLIENT. 


e After the NTF client is deactivated by this command, the 
ACTIVATE_NTF command can be used to reactivate the NTF client 
application. 
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DEACTIVATE_NTF_MAIL 


DEACTIVATE _NTF_ MAIL 


Purpose Deactivates and removes the Network Transfer Facility (NTF) mail system 
task that enables BITNET class M mail to be sent and received by 
Mail/VE Version 1. 


Format DEACTIVATE_NTF_MAIL 
STATUS =status variable 


Parameters STATUS 


Returns the completion status of this command. 


Remarks © The name of the system task deactivated and removed by this 
command is NTF_MAIL_CLIENT. 


o After the NTF_MAIL_CLIENT system task is deactivated by this 
command, the ACTIVATE. NTF_MAIL command can be used to 
reactivate the NTF_MAIL_CLIENT system task. 
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DEACTIVATE_PCNFSD 


DEACTIVATE _PCNFSD 


Purpose Deactivates and removes the system job for the PC Network File System — 
(PCNFSD) server application. 


Format DEACTIVATE _NFS 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system job deactivated and removed by this 
command is PCNFS_.DAEMON. 


@ After the PCNFSD server is deactivated by this command, the 
ACTIVATE._.PCNFSD command can be used to reactivate the PCNFSD 
server application. 
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DEACTIVATE_PORTMAP 


DEACTIVATE _ PORTMAP 
Purpose Deactivates and removes the system job for the Portmapper server 
application. 


Format DEACTIVATE_PORTMAP 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system job deactivated and removed by this 
command is PORTMAP_ DAEMON. 


e After the Portmapper server is deactivated by this command, the 


ACTIVATE. PORTMAP command can be used to reactivate the 
Portmapper server application. 
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DEACTIVATE_PTF 


DEACTIVATE _ PTF 


Purpose Deactivates and removes the system task for the Permanent File Transfer 
Facility (PTF) server application. 


Format DEACTIVATE_PTF 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system task deactivated and removed by this 
command is OSA$FILE_TRANSFER_SERVER. 


e After the PTF server is deactivated by this command, the. 
ACTIVATE_PTF command can be used to reactivate the PTF server 
application. 
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DEACTIVATE_QTF 


DEACTIVATE _QTF 


Purpose Deactivates and removes the system task for the Queue File Transfer 
Facility (QTF) client application. 


Format DEACTIVATE _QTF 
STATUS =status variable 


Parameters STATUS 


Returns the completion status of this command. 


Remarks @ The name of the system task deactivated and removed by this 
command is QUEUE_TRANSFER_ CLIENT. 


e After the QTF client is deactivated by this command, the 
ACTIVATE_QTF command can be used to reactivate the QTF client 
application. 
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DEACTIVATE_QTFS 


DEACTIVATE _QTFS 


Purpose Deactivates and removes the system task for the Queue File Transfer 
Facility Server (QTFS) application. 


Format DEACTIVATE_QTFS 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system task deactivated and removed by this 
command is QUEUE_TRANSFER_SERVER. 


e After the QTF server is deactivated by this command, the 
ACTIVATE_QTFS command can be used to reactivate the QTF server 
application. . 
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DEACTIVATE_SCF 


DEACTIVATE _SCF 


Purpose Deactivates and removes the system task for the Status and Control 
Facility/VE (SCF/VE) client application. 


Format DEACTIVATE _SCF 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks @ The name of the system task deactivated and removed by this 
command is SCF_CLIENT. 


e After the SCF client is deactivated by this command, the ACTIVATE_ 
SCF command can be used to reactivate the SCF client application. 
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DEACTIVATE_SCFS 


DEACTIVATE _SCFS 


Purpose Deactivates and removes the system task for the Status and Control 
Facility Server/VE (SCFS/VE) application. 


Format DEACTIVATE_SCFS 
SYSTEM _TASK_ NAME =name 
STATUS =status variable 


Parameters SYSTEM_TASK_NAME or STN 
Specifies the name of the system task. The name specified for this 
parameter must match the name specified for the SYSTEM_TASK_ 
NAME parameter of the ACTIVATE_SCFS command. The default name 
is SCF_SERVER. 
STATUS 
Returns the completion status of this command. 


Remarks After the SCF server is deactivated by this command, the ACTIVATE_ 
SCFS command can be used to reactivate the SCF server application. 
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DEACTIVATE_SMTP 


DEACTIVATE _SMTP 


Purpose Deactivates and removes the system task for the Simple Mail Transfer 
Protocol (SMTP) client application. 


Format DEACTIVE_SMTP 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks e The name of the system task deactivated and removed by this 
command is SMTP_CLIENT. 


e After the SMTP client is deactivated by this command, the 


ACTIVATE_SMTP command can be used to reactivate the SMTP 
client application. 
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CDCNET Management Entities 6 


This chapter defines and describes COCNET Management Entities and how to activate 
and deactivate them. Descriptions of the commands for activating and deactivating 
Management Entities are included. This chapter also includes brief descriptions of those 
CDCNET and NOS/VE utilities you can use to manage a network. 


Management Entities (MEs) 


CDCNET provides software applications called Management Entities (MEs). MEs 
provide support for network administration and allow network resources to be shared 
between a NOS/VE host and remote CDCNET systems.. 


The MEs supported by NOS/VE are Initialization, File Access, Log, Clock, Command, 
and Alarm. The Initialization, File Access, Log, and Clock MEs provide services to the 
other systems in the network. Each of these entities executes as a system task in the 
system job and is activated and deactivated by NOS/VE operator commands. (These 
commands are described later in this chapter under Management Entity Commands.) 
Only one instance of each ME may be active at a time. 


Initialization ME 


The Initialization ME provides a method for initializing a device interface (DI) on a 
directly connected network. The Initialization ME initializes mainframe DIs that are 
directly connected to a channel on a NOS/VE host computer. A CYBER 930 computer 
can initialize terminal device interfaces (TDIs) and network device interfaces (NDIs) on 
the directly connected ethernet. 


File Access ME 


The File Access ME provides access to network management permanent files for those 
systems in the network that do not support a file storage device. The network 
management files reside in the $SYSTEM.CDCNET catalog on NOS/VE. These files 
provide capabilities to dump, load, and configure DIs. They provide a DI with access to 
terminal, user, operator, and device-load procedures. 


Log ME 


The Log ME records all log messages received from DIs in the network on the 
permanent file $SYSTEM.CDCNET.LOG. Log messages can be generated, for example, 
to note significant events, record statistics, and report status. 


When a log file is terminated for any reason, the LOG_ME task submits a job to 
perform the desired processing on the log file. You can obtain the job file from the file 
$SYSTEM.CDCNET. VERSION_INDEPENDENT.PROCESS.__LOG_JOB. Typical 
functions performed by this job are: executing the log file compression routine for all 
unprocessed log files, archiving or purging the log files, and anne the NOS/VE 
Network Performance Analyzer utility. 
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Clock ME 


Clock ME 

xk 
The Clock ME synchronizes the clocks in DIs in the network. Clock synchronization is 
initiated by the DI being synchronized. The Clock ME provides the current clock value 
to any system requesting it and verifies that the clock is set within acceptable 
tolerances. 


Command and Alarm MEs 


The Command and Alarm MEs are executed in a NOS/VE user job as a command 
utility called Network Operator Utility. For more information about the Network 
Operator Utility, see the CDOCNET Network Operations manual. 


The Command ME allows a network operator to send commands to remote DIs for 
execution and to receive the responses for the commands executed. The operator can 
send commands, for example, to inquire about a DI’s status, request statistics, activate 
or deactivate logging, and execute diagnostics. 


The Alarm ME allows a network operator to receive alarm messages from remote DIs. 
An alarm is a message generated by a DI when an abnormal event occurs. 
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Management Entity Activation and Deactivation 


Management Entity Activation and Deactivation | 
There are two ways to activate an ME: 


@ Enter the ME activation commands at the system console. ME commands cannot be 
executed from an interactive terminal. 


© Include the ME activation commands in the network activation epilog file 
(§SYSTEM.PROLOGS_ AND_EPILOGS.NETWORK~_ACTIVATION_EPILOG) so the 
services are activated automatically during NOS/VE deadstart. Refer to the NOS/VE 
System Performance and Maintenance manual, Volume 2, for more information 
about the network activation epilog file. 


The only way to deactivate an ME is to enter an ME deactivation command from the 
system console. 


Once an ME is activated, you can change parameter values for that ME only by 
deactivating and then reactivating the ME with the new parameter values. 


Management Entity Commands 


This section describes the ME commands you use to activate and deactivate the 
network management services. 


All ME commands have an optional STATUS parameter. Information on using the 
STATUS parameter is in the NOS/VE System Usage manual. 
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ACTIVATE_NETWORK_CLOCK 


ACTIVATE _NETWORK _CLOCK 


Purpose 


Format 


Parameters 


Remarks 


Activates the Clock ME for the network. The network Clock ME allows DI 
clocks throughout the network to be synchronized to a common time. The 
time used for synchronization is obtained from the clock in the NOS/VE 
host that activates the ME. 


NOTE 


The network requires only one network Clock ME. If network Clock MEs 
are activated on more than one DI or NOS/VE host in the network, DI 
clocks may be synchronized only to the extent that the local clocks of the 
various network Clock MEs are synchronized. 


ACTIVATE_NETWORK_CLOCK or 
ACTNC 
MAXIMUM_CONNECTIONS = integer 
STATUS =status variable 


MAXIMUM_CONNECTIONS or MC 
Specifies the maximum number of concurrent connections to the network 


Clock ME. You can specify an integer from 1 to 1000. The default is 1000. 


STATUS 
Returns the completion status of this command. 
You can change network Clock ME parameters only by deactivating the 


ME, then reactivating it with the new parameter values. This action, 
however, interrupts active connections to the network Clock ME. 
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ACTIVATE_NETWORK_FILE_ACCESS 


ACTIVATE __NETWORK _FILE_ACCESS 


Purpose 


Format 


Parameters 


Revision C 


Activates the File Access ME for DlIs that do not support a file storage 
device. 


ACTIVATE _NETWORK _FILE_ACCESS or 
ACTNFA 
FILE_TYPE=list of keyword 
MAXIMUM _CONNECTIONS = integer 
MAXIMUM_ DUMPS = integer 
MAXIMUM _DUMP-_ SIZE = integer 
STATUS =status variable 


FILE_TYPE or FT 


Specifies the list of file types supported by the network File Access ME. 
The network File Access ME registers a title in the network directory for 
each supported file type. See the CDCNET System Programmer's Reference 
Set, Volume 2, for a detailed description of these file types. 


You can specify one or more of the following keywords: 


ALL 
Supports all file types. 


BOOT 
Supports network boot files. 


CONFIGURATION 
Supports network DI configuration files. 


DUMP 
Supports network DI dump files. 


EXCEPTION 
Supports network exception files. 


LIBRARY 
Supports network library files. 


LOAD_ PROCEDURE 
Supports network device-load procedure files. 


OPERATOR_ PROCEDURE 
Supports network operator procedure files. 


TERMINAL_ PROCEDURE 
Supports network terminal procedure files. 


USER_ PROCEDURE 
Supports network user procedure files. 
The default is ALL. 


CDCNET Management Entities 6-5 


ACTIVATE_NETWORK_FILE_ACCESS 


Remarks 


MAXIMUM_CONNECTIONS or MC 


Specifies the maximum number of concurrent connections to the network 
File Access ME. You can specify an integer from 1 to 1000. The default is 
1000. 


MAXIMUM_DUMPS or MD 


Specifies the maximum number of dump files allowed for a given DI. When 
the dump file limit for a DI is reached, the network File Access ME 
rejects attempts to create additional dump files for that DI. You can 
specify an integer from 0 to 1000. The default is 10. 


MAXIMUM_DUMP_SIZE or MDS 


Specifies the maximum size of a dump file in bytes. When a dump file 
reaches this limit, the network File Access ME closes the file and 
terminates the dump. You can specify an integer from 0 to 
4,398,046,511,103 (242 - 1). The default is 4.5 million bytes. 


STATUS 
Returns the completion status of this command. 


e Ifa connection is established to access an unsupported file type, the 
ME issues a log message to the system job log. 


© If the ME detects that a supported file type is unavailable (either at 
activation or as a result of an attempt to reference the file type), the 
ME deletes the file type title from the network directory and issues a 
log message to the system job log. 


© If the ME detects that none of the supported file types are available 
(either at activation or as a result of an attempt to reference the file 
types), it issues a warning message and deactivates itself. When the file 
types are available, the ME must be explicitly reactivated with an 
ACTIVATE_NETWORK_FILE_ACCESS command. 


© You can change the network File Access ME parameters only by 
deactivating the ME, then reactivating it with the new parameter 
values. This action, however, interrupts active connections to the 
network File Access ME. 
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ACTIVATE_NETWORK_INITIALIZER 


ACTIVATE _NETWORK _INITIALIZER 


Purpose Activates the Initialization ME for directly connected DIs that cannot 
self-initialize. 


Format ACTIVATE_NETWORK_INITIALIZER or 
ACTNI 
PRIORITY = integer 
MAXIMUM_ CONNECTIONS = integer 
MAXIMUM_ DUMPS = integer 
MAXIMUM_DUMP_SIZE = integer 
STATUS =status variable 


Parameters PRIORITY or P 


Specifies the priority of the activated network Initialization ME relative to 
other network Initialization MEs in the network. You can specify an 
integer from 0 to 3. The default is 3, which is the highest priority. 


MAXIMUM_CONNECTIONS or MC 


Specifies the maximum number of concurrent connections to the network 
Initialization ME. You can specify an integer from 1 to 1000. The default 
is 1000. 


MAXIMUM_DUMPS or MD 


Specifies the maximum number of dump files allowed for a given DI. When 
the dump file limit for a DI is reached, the ME does not create additional 

dump files when initializing that DI. You-can specify an integer from 0 to 

1000. The default is 10. 


MAXIMUM_DUMP_SIZE or MDS 


Specifies the maximum size of a dump file in bytes. When a dump file 
reaches this limit, the ME closes the file and terminates the dump. You 
can specify an integer from 0 to 4,398,046,511,103 (242— 1). The default is 
4.5 million bytes. 


STATUS 
Returns the completion status of this command. 


Remarks © Once a DI is initialized, it attempts to access its configuration file. 
Access to this file must be provided by a network File Access ME that 
is located on the same network that initialized the DI. 


© You can change the network Initialization ME parameters only by 
deactivating the ME, then reactivating it with the new parameter 
values. This action, however, interrupts active connections to the ME. 


@ Each NOS/VE system that is configured to support a Mainframe Device 
Interface (MDI) or Mainframe Terminal Interface (MTI) must have an 
active network Initialization ME to reload the MDI or MTI in the event 
of a failure. The exception is an MDI that is configured to load across 
another network. An MTI can be loaded only by its host system. 
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ACTIVATE_NETWORK_LOG 


ACTIVATE _NETWORK _LOG 


Purpose 


Format 


Parameters 


Activates the Log ME for Dis that cannot store and analyze log 
information. 


ACTIVATE _NETWORK_LOG or 

ACTNL 
GROUPS =list of (name,integer) 
MAXIMUM _CONNECTIONS = integer 
MAXIMUM _LOG_CYCLES = integer 
MAXIMUM_LOG_SIZE=keyword or integer 
INTERVAL =keyword or integer 
STATUS =status variable 


GROUPS or GROUP or G 


Specifies a list of pairs of values that indicates the name and priority of 
each log group for which log entries are collected. The value specified for 
priority can be an integer in the range from 1 to 255, with 1 being the 
highest priority. The priority for the specified log group is relative to other 
network Log MEs in the network. See the CDCNET Configuration and Site 
Administration Guide for valid names of log groups. The default is 
(CATENET,]1). 


MAXIMUM_CONNECTIONS or MC 


Specifies the maximum number of concurrent connections to the network 
Log ME. You can specify an integer from 1 to 1000. The default is 1000. 


MAXIMUM_LOG_CYCLES or MLC 


Specifies the maximum number of log file cycles allowed. You can specify 
an integer from 2 to 999. The default is 999. 


NOTE 


When log file cycle 999 is reached, logging is disabled in the host until all 


old log file cycles are purged (up to and including cycle 999). Usually, this 
is done by the log file processing job. Once the old cycles are purged, 
logging resumes and writing to log file cycle 1 begins. 


MAXIMUM_LOG_SIZE or MLS 


Specifies the maximum size of a log file cycle in bytes. You can specify an 
integer in the range from 0 to 4,398,046,511,103 (242 - 1). When a log file 
cycle reaches this limit, the log file is closed and processed, and a new log 
file cycle is created. If the keyword NONE is specified, the system-specified 
maximum file size is used (the maximum file size is specified by a system 
configuration parameter). The default is NONE. 
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Remarks 


Revision C 


ACTIVATE_NETWORK_LOG 


INTERVAL or I 


Specifies the time interval in minutes between log file cycles. You can 
specifiy an integer in the range from 1 to 1440. When the specified time 
has elapsed, the active log file cycle is closed and processed, and a new log 
file cycle is started. If the keyword NONE is specified, the ME will not 
process log files. 


STATUS 
Returns the completion status of this command. 


® You can change the network Log ME parameters only by deactivating 
the ME, then reactivating it with new parameter values. This action, 
however, interrupts active connections to the ME. 


@ When the limit on the number of log file cycles is reached, the network 
log service issues a log message and retries at one-minute intervals. 
You must process and delete at least one of the existing log file cycles 
either manually or with the automated log processing job. 


© The network Log ME places log data on a new cycle of the 
$SYSTEM.CDCNET.LOG file. If the log catalog does not exist, it is 
created. When either the log file reaches its maximum size or the log 
file processing interval has elapsed, the current file is closed and a new 
log file cycle is created. 


© When a log file is closed because the file has reached its maximum size 
or the log file processing interval has elapsed, the network Log ME 
submits a job to process the log file. The job file is obtained from file 
$SYSTEM.CDCNET.VERSION_INDEPENDENT.PROCESS_ LOG_JOB. 
This file is included with the CDCNET system release materials and 
contains a sample log file processing job. 


Typically, the job includes these functions (among others): execute the 
log file compression routine for all unprocessed log files, archive or 
purge the log files, and execute the network performance analyzer. 
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DEACTIVATE_NETWORK_CLOCK 


DEACTIVATE _NETWORK_ CLOCK 
Purpose Deactivates the Clock ME for the network. 


Format DEACTIVATE _NETWORK _CLOCK or 
DEANC 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks When the network Clock ME is deactivated, all active connections are 
terminated. 
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~ DEACTIVATE_NETWORK_FILE_ACCESS 


DEACTIVATE _ NETWORK _ FILE _ACCESS 
Purpose Deactivates the File Access ME for the network. 


Format DEACTIVATE _NETWORK _FILE_ ACCESS or 
DEANFA 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks When the network File Access ME is deactivated, all active connections 
are terminated. 
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DEACTIVATE_NETWORK_INITIALIZER 


DEACTIVATE _NETWORK_INITIALIZER 
Purpose Deactivates the Initialization ME for directly connected DIs. 


Format DEACTIVATE _NETWORK _INITIALIZER or 
DEANI 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks ® Each NOS/VE system that is configured to support a Mainframe Device 
Interface (MDI) or Mainframe Terminal Interface (MTI) must have an 
active network Initialization ME to reload the MDI or MTI in the event 
of a failure. The exception is an MDI that is configured to load across 
another network. An MTI can be loaded only by its host system. 
Therefore, under normal operating conditions, do not deactivate the 
network Initialization ME. 


® When the network Initialization ME is deactivated, all active 
connections are terminated. 
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DEACTIVATE_NETWORK_LOG 


DEACTIVATE _NETWORK_LOG 
Purpose Deactivates the Log ME for the network. 


Format DEACTIVATE_NETWORK_LOG or 
DEANL 
STATUS =status variable 
Parameters STATUS 
Returns the completion status of this command. 
Remarks When the network Log ME is deactivated, the current cycle of the 


$SYSTEM.CDCNET.LOG file is closed and returned, and all active 
connections are terminated. 
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Utilities for Network Management 


Utilities for Network Management 


The following CDCNET and NOS/VE utilities can be used to manage a network that 
includes NOS/VE hosts. They give you convenient access to CDOCNET management 
activities involving configuration, report generation, and operator support. 


Manage CDCNET Configuration Utility 


The Manage CDCNET Configurations (MANCC) utility allows you to create and update 
the CDCNET configuration files. The MANCC utility operates as a full-screen editor 
containing function key definitions and help screens. For more information about 
MANCC, see the CDCNET Configuration and Site Administration Guide listed in 
appendix B. 


CDCNET Network Configuration Utility 


The CDCNET Network Configuration Utility (NETCU) is a NOS/VE based utility that 
enables you to enter configuration information for your CDCNET network. Based on 
the information you enter, NETCU creates a configuration database for your network 
and generates CDCNET configuration procedures. For more information about NETCU, 
refer to the NETCU online manual, the NETCU Summary Card, and the CDOCNET 
Configuration and Site Administration Guide listed in appendix B. 


NOTE 


In a future release of NOS/VE, this utility may ecpiace the Manage CDCNET 
Configuration Utility (MANCC). 


Network Performance Analyzer Utility 


The Network Performance Analyzer (NPA) NOS/VE utility produces a wide variety of 
statistical reports that you can use for network planning and for communication-link 
performance evaluating. NPA generates its reports from host-maintained CDCNET log 
files. For more information about NPA, see the CDCNET Network Performance 
Analyzer manual listed in appendix B. 


Network Operator Utility 
The Network Operator Utility (NETOU) provides operator support for CDCNET 


systems. It also implements the Alarm and Command MEs. For more information about 
NETOU, see the CDCNET Network Operations manual listed in appendix B 
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The following commands, CHANGE_NAM_ATTRIBUTES and DISPLAY_NAM_ 
ATTRIBUTES, change and display various NAM/VE attributes. These capabilities allow 
you to tune the operation of NAM/VE to your particular environment and, as a result, 
improve performance and use of resources. It is recommended that the CHANGE_ 
NAM_ATTRIBUTES command be placed in the network activation prolog file 
($SYSTEM.PROLOGS_ AND_EPILOGS.NETWORK_ACTIVATION_PROLOG). The 


network activation prolog file is described in the NOS/VE System Performance and 
Maintenance manual, Volume 2. 
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Tailoring NAM/VE Attributes 


CHANGE _NAM_ATTRIBUTES 


Purpose Modifies specified NAM attributes to improve NAM/VE performance and 
use of network resources. 


Format CHANGE _NAM_ATTRIBUTES or 
CHANA 

ENABLE_CHECKSUMMING = boolean 
ENABLE_ STATISTICS = boolean 
MAXIMUM _CONNECTIONS = integer 
MAXIMUM _ICA_DUMPS = integer 
MAXIMUM _LOGIN_ATTEMPS = integer 
MCI_RESET_DOWN_THRESHOLD=keyword or integer 
ICA_RESET_DOWN _THRESHOLD=keyword or integer 
PREFERRED_PROTOCOL_STACK = keyword . 
ADDITIONAL_LOGIN_ PROMPTS =list of keyword 
STATUS =status variable 


Parameters ENABLE_CHECKSUMMING or EC 


Specifies whether NAM/VE enables checksumming for all locally 
generated messages. 


TRUE 
Checksumming is enabled for locally generated messages. 


FALSE 
Checksumming is not enabled for locally generated messages. 
The default is TRUE. 


ENABLE _STATISTICS or ES 
Specifies whether NAM/VE statistics are collected. 


TRUE 
NAM/VE statistics are collected. 


FALSE 
NAM/VE statistics are not collected. 
The default is FALSE. 


MAXIMUM_CONNECTIONS or MC 


Specifies the maximum number of concurrent connections that NAM/VE 
will support. This maximum is a global maximum that includes all 
connections for all applications. In addition, it includes connections 
required for network management and administrative functions. When the 
total number of connections reaches this limit, no further connections are 
accepted. This attribute should be changed prior to activating NAM/VE. 


The value specified can be from 0 to 4096. The default is 256. 


7-2 Network Management Revision D 


Tailoring NAM/VE Attributes 


NOTE 


When you change the MAXIMUM_CONNECTIONS attribute, 
consideration should be given to changing related system and job class 
attributes, since each NAM/VE connection requires a certain set of 
system resources (for example, maximum jobs, maximum tasks). 


MAXIMUM_ICA_DUMPS or MAXID 


Specifies the maximum number of ICA dump files that may be created 
for each ICA. When the number of dump files for a given ICA reaches 
this limit, no further dumps are taken. 


The value specified can be from 0 to 1000. The default is 3. 


MAXIMUM _LOGIN_ATTEMPTS or MLA 


Specifies the maximum number of login attempts that NAM/VE will 
allow. When the number of unsuccessful login attempts reaches this limit, 
NAM/VE terminates the connection between the host and the network, 
issues an error message to both the user and the system operator, and 
emits a statistic. 


The value specified can be from 1 to 10. The default is 3. 


MCI_RESET_DOWN_THRESHOLD or MRDT 


Specifies the threshold value for MCI reset frequency. When this 
threshold value is reached, NAM/VE changes the element state of an 
MCI to DOWN. The threshold is expressed as the number of resets that 
occur in a 10-minute interval. 


The value specified can be from 2 to 100. The keyword NONE indicates 
that no threshold is to be applied. The default is 10. 


ICA_RESET_DOWN_THRESHOLD or IRDT 


Specifies the threshold value for ICA reset frequency. When this 
threshold value is reached, NAM/VE changes the element state of an ICA 
to DOWN. The threshold is expressed as the number of resets that occur 
in a 10-minute interval. 


The value specified can be from 2 to 100. The keyword NONE indicates 
that no threshold is to be applied. The default is 10. , 


PREFERRED_PROTOCOL_STACK or PPS 


Specifies which protocol stack to use for communications with a CDNA 
bridge system. In a bridge system, the OSI and XNS protocol stacks 
coexist and users of CDNA session and generic transport can 
communicate over either stack. A change in the value of this attribute 
only affects subsequent requests for communication. All communications 
initiated before this change proceed to completion using the protocol stack 
specified at the time. 
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You can specify one of the following keywords: 


OSI 
Selects the Open System Interconnection (OSI) protocol stack. 


XNS 
Selects the Xerox Network Systems (XNS) protocol stack. 
The default is XNS. 


ADDITIONAL_LOGIN_PROMPTS or ALP 


Specifies which prompts are issued during the login dialog in addition to 
the user and password prompts. Changing these attributes may affect 
login dialogs that are already in progress when the change is made. 


You can specify one or more of the following keywords: 


ALL 
Specifies prompting for family, account, and project. 


FAMILY or F 
Specifies prompting for family name. 


ACCOUNT or A 
Specifies prompting for account number. 


PROJECT or P 
Specifies prompting for project number. 


NONE 
Specifies no prompting for family, account, and project. 
The default is FAMILY. 


STATUS 
Returns the completion status of this command. 


Remarks e The CHANGE_NAM_ATTRIBUTES command must be entered at the 
NOS/VE system console. 


© When statistics collection is enabled after having been disabled, the 
statistic values are reinitialized to zero. 


© The statistics collected for NAM/VE are described in the NOS/VE 
System Performance and Maintenance manual, Volume 1. 


© If more than a user name is entered during login, the system 
assumes that all login validation information has been entered and no 
additional prompts are issued. If only a user name is entered after 
the user prompt, the password prompt is issued followed by any 
prompts that are specified on the ADDITIONAL_LOGIN_ PROMPTS 
parameter. 
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DISPLAY_NAM_ATTRIBUTES 
Purpose Displays current NAM attribute values at the operator console. 


Format DISPLAY_NAM_ATTRIBUTES or 
DISNA 
DISPLAY_ OPTIONS =list of keyword . 
OUTPUT =file 
STATUS =status variable 


Parameters DISPLAY_OPTIONS or DO 


Specifies the NAM/VE attribute or attributes for which the current 

values are to he displayed at the system console. All of these attributes 
except CURRENT_CONNECTIONS are listed in the description of the 
CHANGE_NAM_ATTRIBUTES command. The keyword value 
CURRENT_CONNECTIONS requests a display of the current number of 
network connections. If this value is greater than or equal to the value of 
the MAXIMUM_CONNECTIONS attribute, no new connections are 
allowed. 


If you specify the keyword ALL, all attributes are displayed. The default 
is ALL. 


OUTPUT or O 


Specifies the file to which the generated output is to be written. The 
default is $OUTPUT. 


STATUS 
Returns the completion status of this command. 


Remarks The DISPLAY_.NAM_ATTRIBUTES command must be entered at the 
NOS/VE system console. 


Examples The following is a sample DISPLAY_.NAM_ATTRIBUTES display. 


/display_nam_attributes 


Enabie_Checksumming : FALSE 
Enable_Statistics : FALSE 
Maximum_Connect ions : 256 
Current_Connect ions 2 55 
Maximum_ICA_Dumps : 8 
Maximum_Login_Attempts : 3 


ICA_Reset_Down_Threshold : 10 
MCI_Reset_Down_Threshold : 10 
Preferred_Protocol_Stack : XNS 
Prompt_For_Login_Account : FALSE 
Prompt_For_Login_Family : TRUE 
Prompt_For_Login_Project : FALSE 
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Using the MANAGE_STORE_FORWARD_ 
NETWORK Utility 8 


The MANAGE_STORE_FORWARD_NETWORK (MANSEFN) utility is an SCL 
command utility. It follows the rules for utilities given in the NOS/VE System Usage 
manual. 


Except for QUIT, all of the utility subcommands and directives have an optional 
STATUS parameter. Information about using the STATUS parameter is found in the 
NOS/VE System Usage manual. 


You must be validated by the system administrator to use the MANSFN utility. Your 
validation must include the NETWORK_OPERATION capability or the NETWORK_ 
APPLICATION. MANAGEMENT capability. For more information about validation, 
see the NOS/VE User Validation manual. 


This chapter explains how to use the MANSFN utility to do the following. 
e Create and install a MANSFN store-and-forward network file. 
@ Generate and change an existing MANSFN store-and-forward network file. 


e Display information defined for a MANSFN store-and-forward network file. 


Introduction to the MANSFN Utility 


The MANAGE_STORE_FORWARD_NETWORK utility allows a site administrator to 
create store-and-forward configuration information. The Queue File Transfer Facility 
(QTF) then uses this configuration information to transfer queued files between 
arbitrarily named NOS/VE systems even if a non-VE system is somewhere in the 
destination path. 


There are two reasons to use the MANSFN utility to create store-and-forward 
configuration information. First, queued files may need to be forwarded through 
non-VE systems to reach their destinations. The problem is that some systems (NOS 
is an example) use a queued file transfer protocol that can only transfer- 3-character 
source and destination names. Thus, NOS/VE system names like SYSTEM_A and 
SYSTEM_B are truncated to SYS and are no longer unique within the network. 
Since it is impractical to rename all of the families and systems in several networks 
with 3-character names, the MANSFN utility can be used to create a file of 
configuration information that defines unique names as required throughout the 
network. This is done by creating a file of MANSFN directives that defines the 
required name substitutions. This file is called a directives file. The directives file is 
then installed using the MANSFN subcommand INSTALL_STORE_ FORWARD 
NETWORK. The installed directives file is then called a store-and-forward network 
file. This network file’s system name is $SYSTEM.PTF_QTF.STORE_FORWARD_ 
NETWORK. The MANSFN subcommands and directives are described later in this 
chapter. 


The second reason to use the MANSFN utility to create configuration information is 
the need to use more than one queued file transfer application to reach the desired 

destination system. For example, assume the destination system is reachable only by 
way of the Network Transfer Facility (NTF) and the originating system is reachable 
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only by way of QTF. Further assume a bridge system has connections to both the 
originating and destination systems. In this case, the file transfer can be made by 
switching applications from QTF to NTF at the bridge system. This is done by using 
the MANSFN directive DEFINE_ APPLICATION. NAME_SWITCH to define which 
application to use and when to use it. Again, this directive is part of a directives file 
that becomes the store-and-forward network file when the directives file is installed. 


Although a new version of the store-and-forward network file may be installed at any 
time, it does not become active until the next time the QTF client and server 
applications are activated. When a QTF client application begins execution, it 
attaches the highest cycle of the store-and-forward network file and extracts initiator 
related store-and-forward network information from the file. This information is then 
passed to each initiator task as that task starts. Similarly, when a QTF server 
application begins execution, it attaches the highest cycle of the store-and-forward 
network file and extracts server related substitution network information from the 
file. 


The MANSFN utility only creates the store-and-forward network file. It is the 
responsibility of the queued file transfer utilities to search this network file for the 
applicable directives. 


Creating a MANSFN Store-and-Forward Network File 


Use the following steps to create and install a new MANSFN store-and-forward 
network file: 


1. Use the EDIT_FILE utility to create a file of MANSFN utility directives. The 
directives are described in the MANSFN Directives section in this chapter. For 
this example, assume the name of the directives file is SUB_ DIRECTIVES. 


2. Start the MANSFN utility by entering: 
/manage_store_forward_network 


3. Verify the directives file created in step 1 by using the VERIFY_STORE_ 
FORWARD_NETWORK subcommand. If necessary, correct and reverify the file. 
For this example, enter: 


msf/verify_store_forward_network input=sub_direct ives 


4. Install the verified directives file by using the INSTALL_STORE_FORWARD_ 
NETWORK subcommand. For this example, enter: 


msf/install_store_forward_network input=sub_direct ives 
5. Exit the MANSFN utility by using the QUIT subcommand. 


See the NOS/VE File Editor manual for more information about the EDIT_FILE 
utility. 
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Updating a MANSFN Store-and-Forward Network File 


Use the following steps to generate a file of existing MANSFWN utility directives, 
modify the directives file, and install the file to create a new version of the 
store-and-forward network file: 


1. Start the MANSFN utility by entering: 
/manage_store_forward_network 


2. Display the information defined for the existing directives file by using the 
DISPLAY_STORE_FORWARD_NETWORK subcommand. 


msf/display_store_forward_network 
Examine the information and determine what changes you want to make. 


3. Generate a file of the existing directives by using the GENERATE_STORE_ 
FORWARD_NETWORK subcommand. For this example, assume the name of the 
output file is OLD_ DIRECTIVES. 


msf/generate_store_forward_network output=old_direct ives 
4. Modify the directives file (OLD_DIRECTIVES) by using the EDIT_FILE utility. 


5. Verify the modified directives file by using the VERIFY_STORE_FORWARD_ 
NETWORK subcommand. For this example, enter: 


msf/verify_store_forward_network input=old_directives 


6. Install the verified directives file by using the INSTALL_STORE_FORWARD_ 
NETWORK subcommand. For this example, enter: 


msf/install_store_forward_network input=old_directives 


7. Exit the MANSFN utility by using the QUIT subcommand. 


Accessing the MANSFN Store-and-Forward Network File. 


All applications that use the MANSFWN store-and-forward network file (SSYSTEM.PTF_ 
QTF.STORE_ FORWARD_NETWORK) rnust attach the file in shared read mode so that 
other applications can also access the file. This is done by attaching the file using the 

' ATTACH_FILE command and specifying SHARE_MODE=READ. For more information 
about this command, see the NOS/VE Commands and Functions manual. 


MANSFN Command and Subcommands 


This section describes the MANSFN utility command and its subcommands. These 
subcommands are used to display, generate, verify, and install the directives file. The 
directives are described in the MANSFN Directives section later in this chapter. See 
the Examples section later in this chapter for a detailed example of using the 
MANSFN utility. 
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MANAGE _STORE_FORWARD _NETWORK 
Command | 


Purpose Initiates execution of the MANAGE_STORE_ FORWARD NETWORK 
(MANSFN) utility. 


Format MANAGE_STORE_FORWARD_NETWORK or 
MANSFN 
STATUS =status variable 


Parameters STATUS 
Returns the completion status of this command. 


Remarks @ Only one site administrator at a time should use this utility to 
modify the store-and-forward network file. 


@ The prompt for the MANSFN utility is: 


msf/ 
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DISPLAY_STORE_FORWARD_NETWORK 
Subcommand 


Purpose’ 


Format 


Parameters 


Revision D 


Displays information about MANSFN directives that corresponds with the 
contents of the highest cycle of the store-and-forward network file. 


DISPLAY_STORE_FORWARD_NETWORK or 
DISSFN 
NAME =name or string 
APPLICATION. QUALIFIER = keyword 
DISPLAY_ OPTION =list of keyword 
OUTPUT =file 
STATUS =status variable 


NAME or N 

Specifies a search name or string, such as a system name in a network. 
Only those items of information that contain this name or string are to 
be displayed. The default is to display information for all names or 
strings. 

APPLICATION._ QUALIFIER or AQ 


Specifies an application keyword that defines the selection criteria for the 
display. Only those items of information that contain the specified 
application keyword (or for which an application qualifier is not 
applicable) are to be displayed. You can specify one of the following 
keywords: 

NTFI 


Reserved for future use. | 


NTFS 


Reserved for future use. 


QTFI 

Display only those items of information concerning the client 
(initiator) component of the QTF application. 

QTFS 


Display only those items of information concerning the server 
component of the QTF application. 


The default is to display information for all application qualifiers. 


DISPLAY_OPTION or DISPLAY_OPTIONS or DO 
Specifies the type of information to be displayed. You can specify one or 
more of the following keywords: 

APPLICATION_NAME_SWITCH or ANS 


Displays information associated with the DEFINE. APPLICATION _ 
NAME_SWITCH directive. 


DESTINATION_GROUP or DESTINATION_GROUPS or DG 


Displays information associated with the DEFINE_ DESTINATION_ 
GROUP directive. 
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DESTINATION. NAME_SWITCH or DNS 
Displays information associated with the DEFINE_ DESTINATION_ 


NAME_SWITCH directive. 
SOURCE_NAME_SWITCH or SNS 


Displays information associated with the DEFINE_SOURCE_NAME_ 


SWITCH directive. 
ALL 


Displays information associated with all of the MANSFN directives. 


The default is ALL. 
OUTPUT or O 


Specifies the file where the requested display information is to be 


written. The default is $OUTPUT. 
STATUS 


Returns the completion status of this subcommand. 


Examples The following example displays information obtained by entering the 
keyword DESTINATION._.NAME_SWITCH of the DISPLAY_OPTION 


parameter. 


/manage_store_forward_network 


msf/display_store_forward_network do=dest inat ion_name_switch 


DEFINE_DESTINATION_NAME_SWITCH -- INFORMATION 


DESTINATION NAME 
NE XT_HOP_NAME 
APPLICATION_QUALIFIER 


DESTINATION NAME 
NEXT_HOP_NAME 
APPLICATION_QUALIFIER 


DESTINATION NAME 
NEXT_HOP_NAME 
APPLICATION_QUALIFIER 


DESTINATION NAME 


NE XT_HOP_NAME 
APPLICATION_QUALIFIER 
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: FAM_G 
: MMG 
: QTFI 


: FAM_H 
: MMH 
: QTFI 


: MMB 
: FAM_B 
: QTFS 


: MMC 
: FAM_C 
: QTFS 
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GENERATE _STORE_FORWARD _NETWORK 
Subcommand 


Purpose 


Format 


Parameters 


Revision D 


Generates a file of MANSFN directives that corresponds with the contents 
of the highest cycle of the store-and-forward network file. 


GENERATE_STORE_FORWARD_NETWORK or 
GENSFN 
OUTPUT = file 
STATUS =siatus variable 
OUTPUT or O 
Specifies the file where the generated MANSFN directives are to be 
written. This parameter is required. 
STATUS 
Returns the completion status of this subcommand. 


Using the MANAGE_STORE_FORWARD_NETWORK Utility 8-7 


MANSFN Command and Subcommands 


INSTALL_STORE_FORWARD _NETWORK 
Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Installs the specified file of MANSFN directives and creates a new version 
of the store-and-forward network file $;YSTEM.PTF_QTF.STORE_ 
FORWARD_NETWORK. 


INSTALL_STORE _FORWARD_NETWORK or 
INSSFN 

INPUT = file 

ERROR =file 

STATUS =status variable 


INPUT or I 


Specifies the file containing the MANSEN directives that you want to 
install. This parameter is required. 


ERROR or E 


Specifies the file where the MANSFN directives are to be written along 
with any errors detected by this subcommand. The default is $£RRORS. 


STATUS 


Returns the completion status of this subcommand. 


e If the highest cycle of the store-and-forward network file is busy, a 
new cycle will be created; if it is not busy, the highest cycle of the 
file will be overwritten. 


@ The new version of the store-and-forward network file does not 
become active until the next time the QTF client and server 
applications are activated. 


@® Use the VERIFY_STORE_FORWARD_NETWORK subcommand to 
verify the MANSFN directives file before attempting to install the 
file. . 


e If errors are detected in the MANSFN directives file, the 
store-and-forward network file will not be created. 


© Refer to appendix D for descriptions of error messages that may 
appear in the error file. 
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QUIT 
Subcommand 


Purpose Ends a MANSFN utility session. 


Format QUIT or 
QUI 


Parameters None. 
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VERIFY_STORE_FORWARD _NETWORK 
Subcommand 


Purpose Verifies that the MANSFN directives in the input file form a syntactically 
correct and consistent set of store-and-forward network directives. 


Format VERIFY_STORE_FORWARD_NETWORK or 
VERSFN 
INPUT = file 
OUTPUT =file 
STATUS =status variable 
Parameters INPUT or I 


Specifies the file containing the MANSFN directives that you want to 
verify. This parameter is required. 


OUTPUT or O 


Specifies the file where the MANSFN directives are to be written along 
with any error messages concerning the directives. The default is 
$OUTPUT. 


STATUS 


Returns the completion status of this subcommand. 


Remarks @ Use this subcommand to verify the MANSFN directives file before 
attempting to install the file. 


© Refer to appendix D for descriptions of error messages that may 
appear in the output file. 
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MANSFN Directives 


This section describes the MANSFN utility directives. These directives are used to 
define mainframe name substitutions that are to be made for source and destination 
systems when forwarding queued files. These directives are also used to define 
destination groups and to define which queued file transfer applications to use when 
forwarding queued files. See the Examples section later in this chapter for a detailed 
example of using these directives. 
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DEFINE _APPLICATION _NAME_SWITCH 


Directive 


Purpose 


Format 


Parameters 
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Defines the application name substitution to be made when a specified 
application receives a queued file for a specified destination group. 


DEFINE_APPLICATION_NAME_SWITCH or 

DEFANS 
NEXT_HOP_APPLICATION = name 
APPLICATION _QUALIFIER=list of keyword 
DESTINATION._GROUP_ QUALIFIER = name 
STATUS =status variable 

NEXT_HOP_APPLICATION or NHA 


Specifies the name of an application that will be responsible for 
forwarding a queued file on the next hop to its destination. This 
parameter is required. 
APPLICATION _ QUALIFIER or AQ 
Specifies which file transfer server applications can make the name 
substitution. You can specify the following keywords: 

NTFS 

Reserved for future use. 


QTFS 
The server component of the QTF application makes the substitution. 
This parameter is required. 


DESTINATION_GROUP_QUALIFIER or DGQ 


Specifies the name of a destination group. If a value is specified for this 
parameter, the application name substitution defined by this directive 
applies only to files destined for the specified group. If this parameter is 
not specified, the name substitution is made regardless of the file’s 
destination. 


STATUS 
Returns the completion status of this directive. 
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DEFINE _DESTINATION._ GROUP 
Directive 


Purpose Defines a group of destination systems and assigns a name to the group. 
This group of destinations can then be referenced by a single name in 
other directives. 


Format DEFINE _DESTINATION _GROUP or 
DEFDG 
GROUP_NAME_=name 
DESTINATION _NAMES =list of name or string 
STATUS =status variable 
Parameters GROUP_NAME or GN 


Specifies a name by which a group of destination systems can be 
referenced. This parameter is required. 


DESTINATION _NAMES or DN 


Specifies one or more names of destination systems to be included in the 
destination group. This parameter is required. 


STATUS 
Returns the completion status of this directive. 


Remarks Group names must be unique within a host. 
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DEFINE _DESTINATION _NAME_SWITCH 
Directive 


Purpose Defines the destination name substitution to be made when a specified 
application transfers a queued file to a destination system. 


Format DEFINE _DESTINATION_NAME_SWITCH or 
DEFDNS 
NAME =name or string 
NEXT_HOP_NAME=name or string 
APPLICATION _ QUALIFIER = list of keyword 
STATUS =status variable 
Parameters NAME or N 
Specifies the name of a destination system that requires a name 
substitution. This parameter is required. 
NEXT_HOP_NAME or NHN 


Specifies the name to be used in place of the original destination name 
when transferring a queued file to a destination system. This parameter 
is required. 


APPLICATION _QUALIFIER or AQ 


Specifies one or more applications that can make the name substitution. 
You can specify the following keywords: 


NTFI 


Reserved for future use. 


NTFS 
Reserved for future use. 


QTFI 


The client (initiator) component of the QTF application makes the 
substitution before a file is transferred. 


QTFS 


The server component of the QTF application makes the substitution 
after a file is transferred. 


This parameter is required. 


STATUS 
Returns the completion status of this directive. 
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DEFINE_SOURCE_NAME_SWITCH 
Directive : 


Purpose Defines the source name substitution to be made when a specified 
application transfers a queued file to a specified destination group. 


Format DEFINE_SOURCE_NAME_SWITCH or 
DEFSNS 
NAME=name or string 
NEXT_HOP_NAME=name or string 
APPLICATION _ QUALIFIER = list of keyword 
DESTINATION_GROUP_ QUALIFIER =name 
STATUS =status variable 
Parameters NAME or N 
Specifies the name of the source system that requires a name 
substitution. This parameter is required. 
NEXT_HOP_NAME or NHN 


Specifies the name to be used in place of the original source name when 
transferring a queued file from the source system. This parameter is 
required. 
APPLICATION _ QUALIFIER or AQ 
Specifies one or more applications that can make the name substitution. 
You can specify the following keywords: 

NTFI 


Reserved for future use. 


NTFS 


Reserved for future use. 


QTFI 


The client (initiator) component of the QTF application makes the 
substitution before a file is transferred. 


QTFS 


The server component of the QTF application makes the substitution 
after a file. is transferred. 


This parameter is required. 


DESTINATION_GROUP_ QUALIFIER or DGQ 


Specifies the name of a destination group. If a value is specified for this 
parameter, the source name substitution defined by this directive applies 
oniy to files destined for the specified group. If this parameter is not 
specified, the name substitution is made regardless of the file’s 
destination. 


STATUS 
Returns the completion status of this directive. 
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Examples 


The following examples show how to use the MANSFN utility. 


Example 1 


This example uses the combination CDCNET and LCN network configuration shown in 
figure 8-1. In this example, the NOS system M07 uses a queued file transfer protocol 
that can only transfer 3-character source and destination names. Thus, NOS/VE system 
names like FAM_C and FAM_H get truncated to FAM when they are forwarded 
through the NOS system M07. To avoid this problem, use the MANSFN utility to 
define name substitutions for the adjacent NOS/VE systems. 


CDCNET 
FAM_A FAM_B 
NOS/VE NOS/VE 
CDCNET 


L FAM_D | FAM_E 
C | 
N | NOS/VE NOS/VE 


CDCNET 
L : 
C | | 
N FAM_G FAM_H 
~] NOS/VE | NOS/VE 


Figure 8-1. CDCNET/LCN Network Configuration 
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Define the following QTF server titles using the MANNA utility. See chapter 2, 
Understanding Network Applications, for more information about titles and title 
management. 


FAM _A Titles 


FAM _D Titles FAM _G Titles 


FAM_A FAM_D FAM_G - 
FAM_D FAM_A FAM_A 
FAM_E FAM_B FAM_B 
FAM_F FAM_C FAM_C 
FAM_G FAM_G FAM_D 
FAM_H FAM_H FAM_E 
M07 M07 FAM_F 
M07 


Define the following LIDs/PIDs using the MANRN utility. See the LCN Configuration 
and Network Management manual for information about the MANRN utility. 


FAM_A 


define_local_host pid=’MMA’ 1id=(’MMA’, “FANM_A’) 
define_remote_host pid=’MMD’ lid=(’MMD’, “FAM_D’, “FAM_E’, “FAM_F’) 
define_remote_host pid=’M07’ 1id=(’M07’,’MMG’, “MMH’ ) 


FAM_D 


define_locai_host pid=’MMD’ 1id=(’MMD’, “FAN_D’) 
define_remote_host pid=’MMA’ lid=(’MMA‘’,“’FAN_A’,“FAM_B’,“FAM_C’) 
define_remote_host pid=’M07’ 1id=(’MO7’ ,’MMG’ , “MMH” ) 


FAM_G 


define_local_host pid=’MMG’ 1id=(’MMG’, ’FAM_G’ ) 
define_remote_host pid=’M07’ lid=(’MO7’,’MMA’,’MMB’,“’MMC’, .. 
“MMD’ , “MME ’ , “MMF” ) 


Define the destination groups and the source and destination LID name substitutions 
using the following MANSFN utility directives. 


1. Use the DEFINE_ DESTINATION. GROUP directive to define destination groups. 


2. Use the DEFINE_SOURCE_NAME_SWITCH directive to define name 
substitutions to be made by the initiator (client) for outgoing source LIDs. 


3. Use the DEFINE_ DESTINATION. NAME_SWITCH directive to define name 
substitutions to be made by the initiator for outgoing destination LIDs. 


4. Use the DEFINE_ DESTINATION. NAME_SWITCH directive to define name 
substitutions to be made by the server for incoming destination LIDs. 


5. Use the DEFINE_SOURCE_NAME_SWITCH directive to define name 
substitutions to be made by the server for incoming source LIDs. 
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Examples 


FAM_A Substitutions 


define_destination_group gn=GROUP_1 dn=(FAM_B, FAM_C) 
def ine_destination_group gn=GROUP_3 dn=(FAM_G,FAM_H) 


def ine_source_name_switch n=FAM_A nhn=MMA aq=QTFI dgq=GROUP_3 
def ine_source_name_switch n=FAM_B nhn=MMB ag=QTFI dgq=GROUP_3 
def ine_source_name_switch n=FAM_C nhn=MMC aq=QTFI dgq=GROUP_3 


def ine_dest inat ion_name_switch n=FAM_G nhn=MMG 
def ine_destinat ion_name_switch n=FAM_H nhn=MMH 


def ine_destinat ion_name_switch n=MMB nhn=FAM_B 
def ine_dest inat ion_name_switch n=MMC nhn=FAM_C 


def ine_source_name_switch n=MMG nhn=FAM_G aqg=QTFS dgq=GROUP_1 
def ine_source_name_switch n=MMH nhn=FAM_H aq=QTFS dgq=GROUP_1 


FAM _D Substitutions 


aqg=QTFI 
aq=QTFI 


aqg=QTFS 
aqg=QTFS 


define_dest ination _group gn=GROUP_2 dn=(FAM_E,FAM_F) 
define_dest ination_group gn=GROUP_3 dn=(FAM_G,FAM_H) 


def ine_source_name_switch n=FAM_D nhn=MMD aq=QTFI dgq=GROUP_3 
def ine_source_name_switch n=FAM_E nhn=MME aqg=QTFI dgq=GROUP_3 
def ine_source_name_switch n=FAM_F nhn=MMF aq=QTFI dgq=GROUP_3 


def ine_dest inat ion_name_switch n=FAM_G nhn=MMG 
def ine_dest inat ion_name_switch n=FAM_H nhn=MMH 


define_dest inat ion_name_switch n=MME nhn=FAM_E 
define_dest inat ion_name_switch n=MMF nhn=FAM_F 


def ine_source_name_switch n=MMG nhn=FAN_G aqg=QTFS dgq=GROUP_2 
def ine_source_name_switch n=MMH nhn=FAM_H aq=QTFS dgq=GROUP_2 


FAM _G Substitutions 


aq=QTFI 
aq=QTFI 


aq=QTFS 
aq=QTFS 


define_destination_group gn=GROUP_12 dn=(FAM_A, FAM_B,FAM_C, FAM_D, FAM_E, FAM_F) 


def ine_source_name_switch n=FAM_G nhn=MMG ag=QTFI dgq=GROUP_12 
def ine_source_name_switch n=FAM_H nhn=MMH aq=QTFI dgq=GROUP_12 


def ine_dest inat ion_name_switch n=FAM_A nhn=MMA 
def ine_dest inat ion_name_switch n=FAM_B nhn=MMB 
def ine_dest ination_name_switch n=FAM_C nhn=MMC 
def ine_dest inat ion_name_switch n=FAM_D nhn=MMD 
def ine_dest inat ion_name_switch n=FAM_E nhn=MME 
def ine_dest inat ion_name_switch n=FAM_F nhn=MMF 


def ine_dest inat ion_name_switch n=MMH nhn=FAM_H 


aq=QTFI 
ag=QTFI 
aqg=QTFI 
aq=QTFI 
aq=QTFI 
aq=QTFI 


aq=QTFS 


def ine_source_name_switch n=MMA nhn=FAM_A aq=QTFS 
def ine_source_name_switch n=MMB nhn=FAM_B aqg=QTFS 
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Examples 


def ine_source_name_switch n=MMC nhn=FAM_C aq=QTFS 
def ine_source_name_switch n=MMD nhn=FAM_D aq=QTFS 
def ine_source_name_switch n=MME nhn=FAM_E aq=QTFS 
def ine_source_name_switch n=MMF nhn=FAM_F aq=QTFS 


For this example, assume you want to submit a job at system FAM_C, execute the job 
at system FAM_H, and return the output file to the originating system FAM_C. 


The QTF initiator at FAM_C does not make any substitutions because none are 
defined for FAM_C. The job is sent to FAM_A for forwarding. 


The QTF server at FAM_A does not make any substitutions because none of the 
defined substitutions apply. The QTF initiator at FAM_A substitutes source name 
MMC for FAM_C and substitutes destination name MMH for FAM_ H. The job is 
sent to MO7 and then forwarded to FAM_G. 


The QTF server at FAM_G substitutes source name FAM_C for MMC and 
substitutes destination name FAM_H for MMH. The job is sent to its destination 
FAM_H, where it executes. The job’s output is sent back to the originating system 
FAM_C. 


For the return trip, the output file’s origin is FAM_H and its destination is FAM_C. 
Since no substitutions are defined for the QTF initiator at FAM_H, it sends the 
output file to FAM_G for forwarding. 


The QTF initiator at FAM_G substitutes destination name MMC for FAM_C and 
substitutes source name MMH for FAM_H. The output file is sent to M07 and then 
forwarded to FAM_A. 


The QTF server at FAM_A substitutes source name FAM_H for MMH and 
substitutes destination name FAM_C for MMC. The QTF initiator at FAM_A does 
not make any substitutions because none of the defined substitutions apply. The 
output file is sent to its destination FAM_C, where it is put into the output aueue 
for printing. 


Example 2 


This example shows how to use the MANSFN utility to switch applications when it is 
necessary to use more than one file transfer application to reach the desired 
destination. Assume the destination system can be reached only by NTF and the source 
system can be reached only by QTF. Further assume that you want to send a file to 
one of the destination systems within the destination group called GRAY_GROUP. Use 
the following MANSFN utility directives to define the destination group and the 
application name switch. 


' define_dest ination_group gn=GRAY_GROUP dn=(GRAY_A,GRAY_B,GRAY_C) 
def ine_application_name_switch nha=NTF aq=QTFS dgq=GRAY_GROUP 


When the QTF server receives a file with a destination of GRAY_A, GRAY_B, or 
GRAY_C, the server switches the application name to NTF. Thus, the NTF application 
is responsible for forwarding the file on its next hop to its destination. 
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Glossary A 


A 
Application Title 


The logical name or names by which a network server application is known to the 
client. 
Asynchronous TIP 


The terminal interface program (TIP) that configures terminal devices and establishes 
terminal attributes for a generic asynchronous terminal connected to a DI. The 
asynchronous TIP resides in a DI that is configured to support asynchronous terminals. 


B 


Batch Transfer Facility (BTF) 

A group of network applications that allow input to be routed from I/O stations or 
batch streams to a host computer and output to be routed to designated I/O stations or 
batch streams. 

BTF 

See Batch Transfer Facility. 


C 


Catenet 
See Concatenated Network 


CDCNET 


Control Data Distributed Communications Network. CDCNET is the collection of 
hardware and software products offered by Control Data to interconnect computer 
resources (that is, host computer systems, terminals, workstations, unit record devices, 
communications media, and CDCNET device interfaces) into distributed communications 
networks. These hardware and software products are compatible with the Control Data 
Network Architecture (CDNA). : 


CDNA 

Control Data Network Architecture. CDNA is the network architecture designed by 
Control Data to support the recommendations of the International Standards 
Organization’s Open System Interconnection (OSI) model. 

Client Application 

Any network application that is authorized to initiate a connection to a server 
application. See also Server Application. 

Communication Line 


A terminal line that establishes a complete communication circuit between a terminal 
or workstation and a DI. 
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Concatenated Network Instance 


Concatenated Network 


A communications network composed of more than one type of communications 
medium. It is often established when it is necessary to interconnect a local area 
network with other resources (for example, another local area network or 
geographically remote computer-related resources). It is also called a catenet. 
Connection Request Validation 

The validation performed by the server application (or by NAM/VE) when the client 
requests a connection to the server. 

Cycle 


A numbered version of a file that can be registered with the same file name and in 
the same catalog as the other versions of the file. Each permanent file can have from 
1 to 999 cycles. 


D 


Device Interface (DI) 
The communications processor used by Control Data as its CDCNET hardware product. 


DI 


See Device Interface. 


F 


File Transfer Protocol (FTP) 


The Control Data application-to-application protocol that enables applications programs 
executing on one host system to exchange information with applications programs that 
execute on other host systems. 


FTP 
See File Transfer Protocol. 


H 


Host System 


A mainframe computer and its operating system connected to a communications 
network that provides services such as database access, execution of user applications, 
and program compilation. 


I 


Instance 


One execution of an application. 
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Management Entity (ME) Non-NAM/Initiated Server Job 


M 
Management Entity (ME) 


CDCNET software that performs network management functions. There are various 
MEs to perform specific network tasks. 

ME 

See Management Entity. 


Multiconnection Application 


A network application for which one instance of execution can support more than one 
connection. 


N 


NAM/VE 
See Network Access Method/Virtual Environment. 


NAM-Initiated Server Job. | 

A server application job that is initiated by NAM/VE. See also Non-NAM/initiated 
Server Job. 

Network 

_ An interconnected set of host computer systems, terminals, workstations, and unit 
record equipment. 

Network Access Method/Virtual Environment 

The access method that resides on NOS/VE and allows network applications programs 
on the host to exchange information with communications networks. NAM/VE conforms 
to the CDNA. 

Network Address 

A network address specifies the location of an application within a network. A network 
address consists of three parts: a network identifier, a system identifier, and an 
application identifier. 

Network Application 

An application that can communicate with peer applications over a data path called a 
network connection. 

Network Connection 

A data path over which applications communicate. 


Network Transfer Facility (NTF) 

The network applications that support fully-symetrical queued file transfers between a 
NOS/VE host and another host within the network. NTF supports IBM’s Network Job 
Entry (NJE) protocol and HASP multileaving protocol for communication between hosts. 
Non-NAM/Initiated Server Job 


A server job whose corresponding server application contains mechanisms to initiate the 
server application job. 
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NTF Single-Connection Application 


NTF 
See Network Transfer Facility 


Pp 


Permanent File Transfer Facility (PTF) 

The network applications that support file transfers between NOS/VE systems on the 
network. 

Protocol 


A set of conventions that must be followed for communications between the 
computer-related resources in a network. 


PTF 


See Permanent File Transfer Facility. 


Q 


Queue File Transfer Facility (QTF) 


The network applications that support queued file transfers between host systems on 
the network. 


QTF 
See Queue File Transfer Facility 


R 
Ring 


The level of hardware protection given a file or segment. A file is protected from 
unauthorized access by tasks executing in higher rings. 


S 


Server Application 

A network application that is authorized to accept connections from clients. See also 
Client Application. 

Server Application Job 

The job submitted to the system that performs the services provided by the requested 
server application. 

Server Job Validation 


The validation performed when the server application job is submitted to the system. 
For non-NAM/initiated servers, the validation information must be a LOGIN command 
that is the first command in the server job. For NAM-initiated servers, you can specify 
a source for the validation information. 


_Single-Connection Application 


A network application for which one instance of execution can support only one 
connection. 
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T-to-A TIP 


T 
T-to-A 


See Terminal-to-Application Processing. 


Terminal-to-Application Processing 

A type of network processing that enables the exchange of data between applications 
programs that reside on host computers and user terminals or workstations. In this 
case, protocol conversions occur so that transmitted data is understood both at the host 
and the terminal or workstation. 

Terminal Interface Program (TIP) 

A program that provides an interface for terminals connected to a DI. A TIP defines 
line and terminal attributes. 

Timesharing Service 

The NOS/VE network application that allows interactive terminals to connect to 
NOS/VE. 

TIP 


See Terminal Interface Program. 
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Related Manuals B 


All NOS/VE, related NOS (or NOS/BE manuals), and related hardware manuals are 
listed in table B-1. If your site has installed the online manuals, you can find an 
abstract for each NOS/VE manual in the online System Information manual. To access 
this manual, enter: 


/explain 


Ordering Printed Manuals 
To order a printed Control Data manual, send an order form to: 


Control Data Corporation 
Literature and Distribution Services 
308 North Dale Street 

St. Paul, Minnesota 55103 


To obtain an order form or to get more information about ordering Control Data 
manuals, write to the above address or call (612) 292-2101. If you are a Control Data 
employee, call (612) 292-2100. 

Accessing Online Manuals 


To access the online version of a printed manual, log in to NOS/VE and enter the 
online title on the EXPLAIN command (table B-1 supplies the online titles). For 
example, to see the NOS/VE Commands and Functions manual, enter: 


/explain manual=scl 


The examples in some printed manuals exist also in the online Examples manual. To 
access this manual, enter: 


/explain manual=examples 


When EXAMPLES is listed in the Online Manuals column in table B-1, that manual is 
represented in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals 


Manual Title 
NOS/VE Site Manuals: 


CYBER 930 Computer System 
Guide to Operations 
Usage 


CYBER Initialization Package (CIP) 
Reference Manual 


Desktop/VE Host Utilities 
Usage 


MAINTAIN_MAIL2 © 
Usage 


NOS/VE Accounting Analysis System 
Usage 


NOS/VE Accounting and Validation 
Utilities for Dual State 
Usage 


NOS/VE 


LCN Configuration and Network Management 


Usage 


NOS/VE 
Network Management 
Usage 


NOS/VE Operations 
Usage 


NOS/VE 

System Performance and Maintenace 
Volume 1: Performance 

Usage 


NOS/VE 

System Performance and Maintenance 
Volume 2: Maintenance 

Usage 


NOS/VE 
User Validation 
Usage 


Publication 


Number 


60469560 


60457180 


60463918 


60463923 


60458910 


60463917 


60463916 


60463914 


60463915 


60463925 


60464513 


Online 
Manuals! 


MAIM 


1. This column lists the title of the online version of the manual and indicates whether 


the examples in the printed manual are in the online Examples manual. 


2. To access this manual, you must be the administrator for MAIL/VE. 
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Table B-1. Related Manuals (Continued) 


Manual Title 
NOS/VE User Manuals: 


EDIT. CATALOG 
Usage 


EDIT_CATALOG for NOS/VE 
Summary 


Introduction to NOS/VE 
Tutorial 


NOS/VE 
Advanced File Management 
Tutorial 


NOS/VE 
Advanced File Management 
Usage 


NOS/VE 
Advanced File Management 
Summary 


NOS/VE 
Commands and Functions 
Quick Reference 


NOS/VE File Editor 
Tutorial/Usage 


NOS/VE 
Object Code Management 
Usage 


NOS/VE Screen Formatting 
Usage 


NOS/VE ) 
Source Code Management 
Usage 


NOS/VE System Usage 


NOS/VE 
Terminal Definition 
Usage 


Screen Design Facility for NOS/VE 
Usage 


Related Manuals 


Publication Online 


Number 


60487719 
60464012 


60486412 
60486413 
60486419 
60464018 


60464015 


60464413 


60488813 


60464313 


60464014 
60464016 


60488613 


Manuals! 


EDIT_ 
CATALOG 


AFM 


SCL 


EXAMPLES 


EXAMPLES 


EXAMPLES 


EXAMPLES 


SDF 


1. This column lists the title of the online version of the manual and indicates whether 


the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title | Number Manuals! 


CYBIL Manuals: 


CYBIL for NOS/VE 60464114 EXAMPLES 
File Management 
Usage 


CYBIL for NOS/VE 60464117 EXAMPLES 
Keyed-File and Sort/Merge Interfaces 
Usage 


CYBIL for NOS/VE 60464113 CYBIL and 
Language Definition EXAMPLES 
Usage 


CYBIL for NOS/VE 60464116 EXAMPLES 
Sequential and Byte-Addressable Files 
Usage 


CYBIL for NOS/VE 60464115 EXAMPLES 
System Interface 
Usage 


FORTRAN Manuals: 


FORTRAN Version 1 for NOS/VE 60485913 EXAMPLES 
Language Definition 
Usage 


FORTRAN Version 1 for NOS/VE FORTRAN 
Quick Reference 


FORTRAN Version 2 for NOS/VE 60487113 EXAMPLES 
Language Definition | 
Usage 


FORTRAN Version 2 for NOS/VE ; VFORTRAN 
Quick Reference 


FORTRAN for NOS/VE | 60485912 FORTRAN_T 
Tutorial 


FORTRAN for NOS/VE_ | 60485916 
Topics for FORTRAN Programmers 
Usage 


FORTRAN for NOS/VE 60485919 
Summary 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Table B-1. Related Manuals (Continued) 


Manual Title 
COBOL Manuals: 


COBOL for NOS/VE 
Summary 


COBOL for NOS/VE 
Tutorial 


COBOL for NOS/VE 
Usage 


Other Compiler Manuals: 


APL for NOS/VE 
File Utilities 
Usage 


APL for NOS/VE 
Language Definition 
Usage 


BASIC for NOS/VE 
Summary Card 


BASIC for NOS/VE 
Usage 


LISP for NOS/VE 
Usage 


Pascal for NOS/VE 
Summary Card 


Pascal for NOS/VE 
Usage 


Prolog for NOS/VE 
Quick Reference 


Prolog for NOS/VE 
Usage 


Related Manuals 


Publication Online 


Number 


60486019 
60486012 


60486013 


60485814 
60485813 


60486319 
60486313 
60486213 
60485619 
60485613 
60486718 


60486713 


Manuals! 


COBOL_T 


COBOL and 
EXAMPLES 


BASIC 


PASCAL 


PROLOG 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Manual Title 
VX/VE Manuals: 


C/VE for NOS/VE 
Quick Reference 


C/VE for NOS/VE 
Usage 


DWB/VX 
Introduction and User Reference 
Tutorial/Usage 


DWB/VX 
Macro Packages Guide 
Usage 


DWB/VX 
Preprocessors Guide 
Usage 


DWB/VX 
Text Formatters Guide 
Usage 


VX/VE 
Administrator Guide and Reference 
Tutorial/Usage 


VX/VE 
An Introduction for UNIX Users 
Tutorial/Usage 


VX/VE 
Programmer Guide 
Tutorial 


VX/VE 
Programmer Reference 
Usage 


VX/VE 
Support Tools Guide 
Tutorial 


Publication 
Number 


60469830 


60469890 


60469910 


60469920 


60469900 


60469770 


60469980 


60469790 


60469820 


60469800 


1. This column lists the title of the online version of the manual and indicates whether 


the examples in the printed manual are in the online Examples manual. 
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Table B-1. Related Manuals (Continued) 


Manual Title 


VX/VE Manuals (Continued): 


VX/VE 
User Guide 
Tutorial 


VX/VE 
User Reference 
Usage 


Data Management Manuals: 


DM Command Procedures 
Reference Manual 


DM Concepts and Facilities 
Manual 


DM Error Message Summary 
for DM on CDC NOS/VE 


DM Fundamental Query and 
Manipulation Manual 


DM Report Writer 
Reference Manual 


DM System Administrator’s 
Reference Manual 
for DM on CDC NOS/VE 


DM Utilities 
Reference Manual 
for DM on CDC NOS/VE 


Information Management Manuals: 


IM/Control for NOS/VE 
Quick Reference 


IM/Control for NOS/VE 
Usage 


IM/Quick for NOS/VE 
Tutorial 


Related Manuals 


Publication Online 
Number Manuals! 


60469780 . 


60469810 


60487905 


60487900 


60487906 


60487903 


60487904 


60487902 


60487901 


L60488918 CONTROL 


60488913 


60485712 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Manual Title 


Information Management Manuals (Continued): 


IM/Quick for NOS/VE 
Summary 


IM/Quick for NOS/VE 
Usage 


CDCNET Manuals: 
CDCNET Access Guide 


CDCNET Batch Device 
User Guide 


CDCNET Commands 
Quick Reference 


CDCNET Configuration and Site 
Administration Guide 


CDCNET Diagnostic Messages 
CDCNET Conceptual Overview 
CDCNET Network Analysis 

CDCNET Network Configuration Utility 


CDCNET Network Configuration Utility 
Summary Card 


CDCNET Network Operations 
CDCNET Network Performance Analyzer 
CDCNET Product Descriptions 


CDCNET Systems Programmer’s 
Reference Manual Volume 1 
Base System Software 


CDCNET Systems Programmer’s 
Reference Manual Volume 2 


Network Management Entities and Layer Interfaces 


Publication Online 


Number 


60485714 


60463830 
60463863 
60000020 
60461550 


60461600 
60461540 
60461590 


60000269 


60461520 
60461510 
60460590 
60462410 


60462420 


Manuals! 


QUICK 


CDCNET_ 
ACCESS 


CDCNET_ 
BATCH 


NETCU 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. — 
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Table B-1. Related Manuals (Continued) 


Related Manuals 


Publication Online 
Manual Title Number Manuals! 
CDCNET Manuals (Continued): 
CDCNET Systems Programmer’s 60462430 
Reference Manual Volume 3 
Network Protocols 
CDCNET Terminal Interface 60463850 
Usage 
NOS Version 2 Manuals: 
NOS 2 Installation Handbook 60459320 
NOS 2 Operations Handbook 60459310 
NOS 2 Analysis Handbook 60459300 
NOS/BE Version 1.5 Manuals: 
NOS/BE Installation Handbook 60494300 
NOS/BE Operator’s Guide 60493900 
Miscellaneous Manuals: 
Applications Directory 60455370 
CONTEXT 60488419 
Summary Card 
CYBER Online Text for NOS/VE 60488403 CONTEXT 
Usage 
Control Data CONNECT 60462560 
User’s Guide 
Debug for NOS/VE DEBUG 
Quick Reference 
Debug for NOS/VE 60488213 
Usage 
Desktop/VE for Macintosh 60464502 
Tutorial 
Desktop/VE for Macintosh 60464503 


Usage 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


Miscellaneous Manuals (Continued): 


MAIL/VE 60464519 
Summary Card 


MAIL/VE MAIL_ VE 
Usage 


NOS Online Maintenance Software 60454200 
Reference Manual 


NOS/VE Diagnostic Messages 60464613 MESSAGES 
Usage 


NOS/VE Examples EXAMPLES 
Usage 


NOS/VE System Information NOS_VE 


Programming Environment ENVIRON- 
for NOS/VE MENT 
Usage 


Programming Environment 60486819 
for NOS/VE 
Summary 


Remote Host Facility 60460620 
Usage 


Hardware Manuals: 


CYBER 170 Computer Systems 60459960 
Models 825, 835, and 855 

General Description 

Hardware Reference 


CYBER 170 Computer Systems, Models 815, 825, 835, 60458100 
845, and 855 

CYBER 180 Models 810, 830, 835, 840, 845, 850, 855, 

and 860 

Codes Booklet 


CYBER 170 Computer Systems, Models 815, 825, 835, 60458110 
845, and 855 

CYBER 180 Models 810, 830, 835, 840, 845, 850, 855, 

and 860 

Maintenance Register 

Codes Booklet 


1. This column lists the title of the online version of the manual and indicates whether 


the examples in the printed manual are in the online Examples manual. 
(Continued) 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


Hardware Manuals (Continued): 


HPA/VE Reference 60461930 
Virtual State Volume II 60458890 
Hardware Reference 

7021-31/32 Advanced Tape Subsystem 60449600 
Reference 

7221-1 Intelligent Small 60461090 
Magnetic Tape Subsystem 

Reference 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Desktop Environment (Desktop/VE) Application ............. ach se a sock H C-1 
Permanent File Transfer Facility (PTF) Applications.................. C-1 
Chent Applications. :5.9:6 2b 6 4 6a wae 4 Sk Boe ee ee REARS C-1 
DEFVer ApplCa ON 6.6.3; ee pecke d,s EI oe MR a A tk we a GPM C-2 
Queue File Transfer Facility (QTF) Applications ................2..2.004 C-2 
Client Application: 4:.5010 os 4-6 Sow snes Secs ak Seow Goh we Se As: 2 ae OO C-2 
perver Application. iy: <.22:5.00 Aes fc te pia alo, We Sa a Ee ee ee, we C-3 
Batch Transfer Applications ...........0..0 2.0. eee ee ee ee C-3 
Status and Control Facility (SCF) Application .................... C-3 
Batch Transfer Facility (BTF) Application ................0-.2. 0004 C-4 
Operate Station Utility (OPES) Application. ..................0... C-4 
Status and Control Facility Server (SCFS) Application .............. . C-4 
Batch Transfer Facility Server (BTFS) Application ................. C-5 
Network Transfer Facility (NTF) Applications. ... . ile ema a, ae, cd as woh eatin nik A C-5 
Network Transfer Facility (NTF) Application. ..................0.. C-5 
Operate Network Transfer Facility (OPENTF) Application ............. C-6 
File Transfer Protocol (FTP) Applications ....... BS ge Met ita ee En tes ne, de SE So C-6 
Client Application ............. 02.00. e ee eee Pgecarfas ete Os Rat C-6 


Server Application: 2 42 662.6% gee was pS ae KR A a De ee B® eH RO C-6 


Default Network Application Definitions C 


This appendix gives the default application definitions for network applications created 
by the NOS/VE installation process. This appendix also explains how to activate the 
definition using MANNA subcommands. 


Timesharing Application 


The define_timesharing_ application option of the DEFINE_NETWORK command 
produces the following subcommands for defining the Timesharing application: 


define_server server=osa$t imesharing protocol=cdna_virtual_terminal .. 
nam_initiated=true 
add_titles titles="title or titles supplied by the site” 
change_maximum_connections maximum_connect ions=200 
change_connect ion_priority connection_priority=6 
change_server_validation capability=none ring=3 system_privilege=false 
change_client_validation capability=t imesharing 
change_server_job job=$nul1 validation_source=client maximum_connections=1 . 
end_def ine_server 


The Timesharing application is activated by the MANNA subcommand: 


activate_server osa$timeshar ing 


Desktop Environment (Desktop/VE) Application 


The DEFINE_DESKTOP_ENVIRONMENT command produces the following 
subcommands for defining the Desktop Environment client application: 


define_client client=desktop_ve protocol=cdna_virtual_terminal] 
end_def ine_client , 


This application is activated by the MANNA subcommand: 


activate_client client=desktop_ve 


Permanent File Transfer Facility (PTF) Applications 


Client Application 


The DEFINE_PTF command produces the following subcommands for defining the 
Permanent File Transfer Facility client application: 


define_client client=osa$file_transfer_client protocol=cdna_session 
change_maximum_connections maximum_connect ions=40 
change_client_validation system_privilege=true 
change_application_identifier application_identifier=2001 
change_connection_priority connect ion_priority=4 
end_define_ciient 


This application is activated by the MANNA subcommand: 


activate_client client=osa$file_transfer_client 
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Queue File Transfer Facility (QTF) Applications 


Server Application 


The DEFINE_PTF command produces the following subcommands for defining the 
Permanent File Transfer Facility server application: 


define_server server-osa$file_transfer_server protocol=cdna_session .. 
nam_initiated=false 
add_titles title=ptfs$xxx "Where xxx is the name by which remote 
users access this server. The title or list of titles is supplied 
by the site.” 
change_maximum_connect ions maximum_connect ions=40 
change_server_validation system_privilege=true 
add_client_address system_identifier=nosve applicat ion_ident ifier=2001 
add_client_address system_identifier=cdcnet "allows any NOS gateway DI" 
change_accept_connection accept_connect ion=false 
change_connect ion_priority connect ion_priority=4 
end_def ine_server 


This application is activated by the MANNA subcommand: 


activate_server server=osa$file_transfer_server 


Queue File Transfer Facility (QTF) Applications 


Client Application 


The DEFINE_QTF command produces the following subcommands for defining the 
Queue File Transfer Facility client application: 


define_client client=osa$queue_transfer_client protocol=cdna_session 
change_connection_priority connect ion_priority=4 
change_maximum_connect ions maximum_connect ions=40 
change_client_validation system_privilege=true 
change_application_identifier applicat ion_ident if ier=2006 

end_def ine_client 


This application is activated by the MANNA subcommand: 


activate_client client=osa$queue_transfer_client 
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Batch Transfer Applications 


Server Application 


The DEFINE_QTFS command produces the following subcommands for defining the 
Queue File Transfer Facility server application: 


define_server server=osa$queue_transfer_server protocol=cdna_session .. 
nam_initiated=false 
change_connection_priority connect ion_priority=4 
change_maximum_connect ions maximum_connect ions=40 
change_server_validation system_privilege=true 
change_accept_connection accept_connect ion=false 
add_client_address system_identifier=nosve applicat ion_identifier=2006 
add_client_address system_identifier=cdcnet application_identifier=all 
add_titles qtfs$xxxx broadcast_registration=true “Where xxxx is the 
name by which remote users access this server. The title or list of titles 
is supplied by the site." 
end_def ine_server 


This application is activated by the MANNA subcommand: 


activate_server server=osa$queue_transfer_server 


Batch Transfer Applications 


Status and Control Facility (SCF) Application 


The DEFINE_SCF command produces the following subcommands for defining the 
Status and Control Facility client application: 


define_client client=osa$status_control_fac_client protocol=cdna_session 
change_application_identifier application_identifier=2002 "“SCF/VE identifier” 
change_maximum_connect ions maximum_connect ions=20 
change_client_validation system_privi lege=true 
change_connection_priority connect ion_priority=5 

end_define_client 


This application is activated by the MANNA subcommand: 


activate_client client=osa$status_control_fac_client 
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Batch Transfer Applications 


Batch Transfer Facility (BTF) Application 


The DEFINE_BTF command produces the following subcommands for defining the 
Batch Transfer Facility client application: 


define_client client=osa$batch_transfer_client protocol=cdna_session 
change_maximum_connect ions maximum_connect ions=20 
change_client_validation system_privilege=true 
change_connection_priority connect ion_priority=2 

end_define_client 


This application is activated by the MANNA subcommand: 


activate_client client=osa$batch_transfer_client 


Operate Station Utility (OPES) Application 


The DEFINE_OPES command produces the following subcommands for defining the 
Operate Station Utility application: 


define_client client=osa$station_operator protocol=cdna_session ; 
change_application_identifier application_identifier=2003 "OPES identifer” 
change_maximum_connect ions maximum_connect ions=20 
change_connection_priority connect ion_priority=5 

end_define_client 


This application is activated by the MANNA subcommand: 


activate_client client=osa$stat ion_operator 


Status and Control Facility Server (SCFS) Application 


The DEFINE_SCFS command produces the following subcommands for defining the 
Status and Control Facility Server application: 


def ine_server osa$status_control_fac_server protocol=cdna_session .. 
nam_initiated=false 
change_maximum_connections maximum_connect ions=40 
change_server_validation system_privilege=true 
add_client_address application_identifier=2002 "SCF/VE identifier" 
add_client_address application_identifier=2003 “OPES identifier" 
add_ciient_address application_identifier=2004 "NTF identifier" 
add_client_address application_identifier=2005 "“OPENTF identifier" 
add_client_address system_identifier=cdcnet applicat ion_identifier=al] 
add_server_managed_title title pattern=’SCF[AS]$*’ 
change_accept_connection accept_connect ion=false 
change_connection_priority connect ion_priority=5 
end_define_server 


This application is activated by the MANNA subcommand: 


activate_server server=osa$status_control_fac_server 
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Network Transfer Facility (NTF) Applications 


Batch Transfer Facility Server (BTFS) Application 


The DEFINE_BTFS command produces the following subcommands for defining the 
Batch Transfer Facility Server application: 


define_server server=osa$batch_transfer_server protocol=cdna_session .. 
nam_initiated=false 
add_title title=btfs$xxx “Where xxx is the job destination name used 
to access this server. The title or list of tities is supplied by 
the site." 
change_maximum_connections maximum_connect ions=40 
change_server_validation system_privilege=false 
add_client_address system_identifier=cdcnet application_identifier=all 
change_accept_connection accept_connect ion=false 
change_connection_priority connection_prior ity=2 
end_def ine_server 


This application is activated by the MANNA subcommand: 


activate_server server=osa$batch_transfer_server 


Network Transfer Facility (NTF) Applications 


Network Transfer Facility (NTF) Application 


The DEFINE_NTF command produces the following subcommands for defining the 
Network Transfer Facility application: 


define_client client=osa$network_transfer_fac_client protocol=cdna_session 
change_application_identifier application_identifier=2004 "NTF identifier" 
change_maximum_connect ions maximum_connect ions=20 
change_client_validation system_privilege=true 
change_connection_priority connection_priority=5 

end_define_client 


This application is activated by the MANNA subcommand: 


activate_client ciient=osa$network_tansfer_fac_client 
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File Transfer Protocol (FTP) Applications 


Operate Network Transfer Facility (QPENTF) Application 


The DEFINE_OPENTF command produces the following subcommands for defining the 
Operate Network Transfer Facility application: 


define_client osa$ntf_operator protocol=cdna_session 
-change_applications_identifier application_identifier=2005 .. 
“OPENTF identifier" 
change_maximum_connections maximum_connect ions=20 
change_connection_priority connect ion_priority=5 
end_define_client 


This application is activated by the MANNA subcommand: 


activate_client client=osa$ntf_operator 


File Transfer Protocol (FTP) Applications 


Client Application 


The DEFINE_FTP command produces the following subcommands for defining the File 
Transfer Protocol client application: 


define_client client=osa$ftp_client protocol=cdna_session 
change_maximum_ connections maximum_connect ions=40 
end_define_client 


This application is activated by the MANNA subcommand: 


activate_client client=osa$ftp_client 


Server Application 


The DEFINE_FTPS command produces the following subcommands for defining the 
File Transfer Protocol server application: 


define_client client=osa$ftp_server protocol=cdna_session 
change_maximum_connect ions maximum_connect ions=40 
change_client_validation system_privilege=true 

end_def ine_client 


This application is activated by the MANNA subcommand: 


activate_client client=osa$ftp_server 
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Simple Mail Transfer Protocol (SMTP) Applications 


Simple Mail Transfer Protocol (SMTP) Applications 


Client Application 


The DEFINE_SMTP command produces the following subcommands for defining the 
Simple Mail Transfer Protocol client application: 


define_client client=osa$smtp_client protocol=cdna_session 
change_maximum_connect ions maximum_connect ions=100 
end_define_client 


This application is activated by the SCL procedure: 


activate_smtp 


Server Application 


The DEFINE_SMTPS command produces the following subcommands for defining the 
Simple Mail Transfer Protocol server application: 


define_client client=osa$smtp_server protocol=cdna_session 
change_maximum_connections maximum_connect ions=100 
change_client_validation system_privilege=true 

end define_client 


This application is activated as a system task by the Internet Daemon (INETD) when 
an SMTP connection request is received on port 25 (the Simple Mail Transfer 
Protocol well-known port). 


Interprocess Communication (IPC) Application 


The DEFINE_IPC_APPLICATIONS command produces the following subcommands for 
defining the Interprocess Communication client application: 


define_client client=osa$ipc_applications protocol=cdna_session 
change_maximum_connect ions maximum_connect ions=40 
change_client_validation system_privilege=true 
end_define_client 


This application is activated as a system job by the MANNA subcommand: 


activate_client client=osa$ipc_applications 
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Error Messages e D 


Diagnostic Description Format 


Error Messages 


Error Messages D 


Diagnostic Description Format 


The following information is provided for each message: 


The condition code. 


The full mode message text with variable fields represented as follows: 


{file} Represents a file name or file path contained in the actual 
message. 
{text} Represents replacement text contained in the actual message. 


The condition identifier, followed by a repetition of the condition code. 
A description of the message. 
Suggested user action to correct the problem. 


Further information (when applicable). 


Condition identifiers (names) should be used instead of condition codes to test for 
specific conditions in SCL jobs and procedures. For example, condition code NF 600 has 
the condition identifier NFE$SF_CALLER_NOT_PRIVILEGED. Refer to condition 
processing in the NOS/VE System Usage manual for more information about 
structuring jobs and testing for abnormal conditions. Also, see the $CONDITION_ 
NAME function in the NOS/VE System Usage manual for information about 
determining and using the condition identifier in an SCL job. 
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Error Messages 


Error Messages 


--FATAL NF 600-- Caller not validated to {text}. 
Condition Identifier: NFE$SF_CALLER_NOT_PRIVILEGED Code: NF 600 


Description: To use the MANAGE_STORE_FORWARD_NETWORK utility, you must be validated for the 
capability of NETWORK_OPERATION or NETWORK_APPLICATION_MANAGEMENT. 


User Action: Ask the site administrator to validate you for the NETWORK_OPERATION or NETWORK_ 
APPLICATION_MANAGEMENT capability. 


-INFORMATIVE NF 601-- Combine the multiple definitions of DEFINE_ 
APPLICATION _NAME_SWITCH, that have the destination _ group _ qualifier 
value of {text}, next_hop_application value of {text} and the application _ 
qualifiers are a subset of one or the other into one definition. 

Condition Identifier: NFE$SF_COMBINE_DUP_APPL_DEF Code: NF 601 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
APPLICATION_NAME_SWITCH directives that contain a subset of identical information. 


User Action: Combine all applicable directives into one directive. 


-INFORMATIVE NF 602-- Combine the multiple definitions of DEFINE_ 
SOURCE_NAME_SWITCH, that have the name value of {text}, next_hop_name 
value of {text}, destination _group_ qualifier value of {text}, and the application _ 
qualifiers are a subset of one another into one definition. 

Condition Identifier: NFE$SF_COMBINE_DUP_SOURCE_DEF Code: NF 602 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
SOURCE_NAME_SWITCH directives that contain a subset of identical information. 


User Action: Combine all applicable directives into one directive. 


-INFORMATIVE NF 603-- Combine the multiple definitions of DEFINE_ 
DESTINATION _NAME_SWITCH, that have the name value of {text}, next_hop_ 
name value of {text} and the application_qualifiers are a subset of one another 
into one definition. 

Condition Identifier: NFE$SF_COMBINE_DUP_TARGET_DEF Code: NF 603 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
DESTINATION_NAME_SWITCH directives that contain a subset of identical information. 


User Action: Combine al] applicable directives into one directive. 


--FATAL NF 604-- The DESTINATION _GROUP_QUALIFIER {text} has not been 
defined. 

Condition Identifier: NFE$SF_DEST_GROUP_NOT_FOUND Code: NF 604 

Description: The destination group qualifier has not been defined. 


User Action: Define the destination group by using the MANAGE_STORE_FORWARD_NETWORK 
directive DEFINE_DESTINATION_GROUP. : 


--FATAL NF 605-- The multiple definitions of DEFINE_APPLICATION _NAME_ 
SWITCH, that have the destination _group_ qualifier value of {text} and 
overlapping application _ qualifiers have different next_hop_ applications. 
Condition Identifier: NFE$SF_DIF_NHA_SAME_AQ_AND_DGQ _ Code: NF 605 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
APPLICATION_NAME_SWITCH directives that contain identical values for the parameters 
APPLICATION_QUALIFIER and DESTINATION_GROUP_QUALIFIER but different values for the 
parameter NEXT_HOP_APPLICATION, 


User Action: Change the NEXT_HOP_APPLICATION to the correct value or change the APPLICATION _ 
QUALIFIER or DESTINATION_GROUP_QUALIFIER parameters to different values. 
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--FATAL NF 606-- The multiple definitions of DEFINE. SOURCE_NAME_ 
SWITCH, that have the name value of {text}, destination _group_ qualifier value 
of {text} and overlapping application _ qualifiers have different next_hop_names. 
Condition Identifier: NFE$SF_DIF_NHN_SAME_N_AQ_ DGQ _ Code: NF 606 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
SOURCE_NAME_SWITCH directives that contain identical values for the parameters NAME, 
APPLICATION_QUALIFIER, and DESTINATION _GROUP_QUALIFIER but different values for the 
parameter NEXT_HOP_NAME. 


User Action: Change the NEXT_HOP_NAME to the correct value or change the NAME or 
APPLICATION_QUALIFIER or DESTINATION_GROUP_QUALIFIER parameters to different values. 


--FATAL NF 607-- The multiple definitions of DEFINE_DESTINATION_NAME_ 
SWITCH, that have the name value of {text} and overlapping application _ 
qualifiers have different next_hop_names. 


Condition Identifier: NFE$SF_DIF_NHN_SAME_N_AND_AQ Code: NF 607 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
DESTINATION_NAME_SWITCH directives that contain identical values for the parameters NAME 
and APPLICATION_QUALIFIER but different values for the parameter NEXT_HOP_NAME. 


User Action: Change the NEXT_HOP_NAME to the correct value or change the NAME or 
APPLICATION_QUALIFIER parameters to different values. 


-FATAL NF 608-- MANAGE_STORE_FORWARD_NETWORK has encountered 
directive errors, see file: {text} for additional error information. 


Condition Identifier: NFE$SF_DIRECTIVE_ERRORS Code: NF 608 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has encountered fatal directive errors 
that cannot be processed. 


User Action: Look at the output file for the MANAGE_STORE_FORWARD_NETWORK utility for 
additional information about the directive errors, and then correct the errors. 


-FATAL NF 609-- The DEFINE_APPLICATION_NAME_SWITCH, that have the 
destination _group_ qualifier value of {text} and next_hop_application value of 
{text} has multiple definitions with overlapping application _ qualifiers. 

Condition Identifier: NFE$SF_DUPLICATE_APPL_DEF Code: NF 609 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
APPLICATION_NAME_SWITCH directives for the same NEXT_HOP_APPLICATION and 
DESTINATION_GROUP_QUALIFIER values but different APPLICATION_QUALIFIER values. 


User Action: Delete or change the invalid directive. 


-FATAL NF 610-- The DEFINE_DESTINATION_GROUP, that has the group_ 
name value of {text} has multiple definitions. 


Condition Identifier: NFE$SF_DUPLICATE_GROUP_NAMES Code: NF 610 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
DESTINATION_GROUP directives for the same GROUP_NAME value. 


User Action: Delete or change the invalid directive. 


-FATAL NF 611-- The DEFINE_SOURCE_NAME_SWITCH, that have the name 
value of {text} and next_hop_name value of {text} has multipie definitions with 
overlapping application _ qualifiers and destination _ group _ qualifiers. 


Condition Identifier: NFE$SF_DUPLICATE_SOURCE_DEF Code: NF 611 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
SOURCE_NAME_SWITCH directives for the same NAME and NEXT_HOP_NAME values but 
different APPLICATION_ QUALIFIER and DESTINATION_GROUP_QUALIFIER values. 


User Action: Delete or ae the invalid directive. 
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--FATAL NF 612-- The DEFINE_DESTINATION _NAME_SWITCH, that have the 
name value of {text} and next_hop_name value of {text} has multiple definitions 
with overlapping application _ qualifiers. 

Condition Identifier: NFE$SF_DUPLICATE_TARGET_DEF Code: NF 612 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
DESTINATION_NAME_SWITCH directives for the same NAME and NEXT_HOP_NAME values but 
different APPLICATION_QUALIFIER . values. 


User Action: Delete or change the invalid directive. 


-INFORMATIVE NF 613-- The DEFINE_DESTINATION_GROUP directive for 
the group_name {text} was not used as a destination_group_ qualifier in any 
other directives. 

Condition Identifier: NFE$SF_GROUP_NAME_NOT_USED Code: NF 613 


Description: The MANAGE_STORE_FORWARD_NETWORK utility DEFINE_DESTINATION_GROUP 
directive is not used in any other directive. 


User Action: Delete the unused directive. 


-INFORMATIVE NF 614-- The DEFINE_DESTINATION _GROUP, that has the 
group_name {text} has the identical destination names as group_name {text}. 


Condition Identifier: NFE$SF_IDENTICAL_DEST_LIST Code: NF 614 


Description: The MANAGE_STORE_FORWARD_NETWORK utility has found multiple DEFINE_ 
DESTINATION_GROUP directives with different GROUP_NAME values but identical destination 
names. 


User Action: Correct the directives to use only one GROUP_NAME and delete the unused directive. 


--FATAL NF 615-- An invalid pointer type has been encountered in the 
procedure: {text} 

Condition Identifier: NFESSF_INTERNAL_ERROR_BAD_PTR Code: NF 615 

Description: An internal error has occurred in the MANAGE_STORE_FORWARD_NETWORK utility. 
User Action: Reinstall the MANAGE _STORE_FORWARD_NETWORK directive file. 


-CATASTROPHIC NF 616-- An invalid pointer type has been encountered in the 
procedure: {text} please re-install the SYSTEM’s Store/Forward Network File. 


Condition Identifier: NFE$SF_INTERNAL_ERROR_BAD_RPTR Code: NF 616 
Description: An internal error has occurred in the MANAGE_STORE_FORWARD_NETWORK utility. 
User Action: Reinstall the MANAGE _STORE_FORWARD_NETWORK directive file. 


--ERROR NF 617-- The name value {text} must be no longer than 31 characters 
in length for a {text}. 
Condition Identifier: NFE$SF_NAME_TOO_LONG Code: NF 617 


Description: A name value supplied for a MANAGE_STORE_FORWARD_NETWORK directive parameter 
is too long. 


User Action: Shorten the name to a value less than or equal to 31 characters. 


--ERROR NF 618-- The name value {text} must be at least 3 characters in length 
for a {text}. 
Condition Identifier: NFE$SF_NAME_TOO_SHORT Code: NF 618 


Description: A name value supplied for a MANAGE_STORE_FORWARD_NETWORK directive parameter 
is too short. , 


User Action: Lengthen the name to a value greater than or equal to 3 characters. 
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--FATAL NF 619-- The System’s Store/Forward Network File does not exist, 
please install it. 

Condition Identifier: NFE$SF_NO_STORE_FORWARD_NETWORK Code: NF 619 

Description: The MANAGE_STORE_FORWARD_NETWORK directive file has not been installed. 
User Action: Install the MANAGE STORE_FORWARD_NETWORK directive file. 


--CATASTROPHIC NF 620-- Errors encountered on reading the System’s 
Store/Forward Network File. 
Condition Identifier: NFE$SF_READ_NETWORK_FILE_ERROR Code: NF 620 


Description: The installed version of the MANAGE _STORE_FORWARD_NETWORK directive file has been 
corrupted. 


User Action: Reinstall the MANAGE_STORE_FORWARD_NETWORK directive file. 


-ERROR NF 621-- The string value {text} must be no longer than 31 characters 
in length for a {text}. 
Condition Identifier: NFE$SF_STRING_TOO_LONG Code: NF 621 


Description: A string value supplied for a MANAGE_STORE_FORWARD_NETWORK directive parameter 
is too long. 


User Action: Shorten the string to a value less than or equal to 31 characters. 


-ERROR NF 622-- The string value {text} must be at least 3 characters in length 
for a {text}. 
Condition Identifier: NFE$SF_STRING_TOO_SHORT Code: NF 622 


Description: A string value supplied for a MANAGE _STORE_FORWARD_NETWORK directive parameter 
is too short. 


User Action: Lengthen the string to a value greater than or equal to 3 characters. 


--CATASTROPHIC NF 623-- Installation of System’s Store/Forward Network File 
failed due to errors encountered on writing the Store/Forward Network File. 


Condition Identifier: NFESSF_WRITE_NETWORK_FILE_ERROR Code: NF 623 


Description: The MANAGE_STORE_FORWARD_NETWORK directive file cannot be installed due to 
system errors. 


User Action: Try to reinstall the MANAGE _STORE_FORWARD_NETWORK directive file. 
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Client address 3-15 
Client capability 3-13 
Client information source 3-16 
Client ring 3-13 
Client system privilege 3-14 
Client, table of 3-11 
Client validation 3-16 
Connection priority 
Client 3-14 
Server 3-16 
Description 3-11 
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Maximum connections 
Client 3-14 
Server 3-17 
NAM-initiated 3-17 
Protocol 
Client 3-14 
Server 3-17 
Server capability 3-17 
Server job 3-18 
Server job maximum connections 3-18 
Server job validation source 3-18 
Server managed titles 3-18 
Server ring 3-19 
Server system privilege 3-19 
Server, table of 3-12 
Title 3-19 
Title data 3-19 
Title priority 3-19 
Application definitions file update 3-10 . 
Application identifier attribute 
Client 3-13 
Server 3-15 
Application title (see also Server 
application titles) 2-10 


B 


Batch Transfer Facility services 
Default definition for C-4 
Description 2-16.1 

Broadcast registration attribute 3-15 

BTF 2-16.1, 17, 18, 19; C-4 

BTFS 2-17, 18, 19; C-5 


C 


CDCNET Management Entities 6-1 
CDCNET Network Configuration Utility 
(NETCU) 6-14 

CDNA_SESSION protocol 3-14 

CDNA_ VIRTUAL_ TERMINAL 
protocol 3-14 

CHANGE_ ACCEPT_CONNECTION 
CHAS subcommand 4-10 

CHANGE ACCEPT_ CONNECTION 
DEFS subcommand 4-10 

CHANGE APPLICATION _IDENTIFIER 
CHAC subcommand 4-11 

CHANGE_ APPLICATION _IDENTIFIER 
CHAS subcommand 4-12 

CHANGE APPLICATION _IDENTIFIER 
DEFC subcommand 4-11 

CHANGE_ APPLICATION _IDENTIFIER 
DEFS subcommand 4-12 

CHANGE_ CLIENT MANNA 
subcommand 4-13 
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CHANGE_CLIENT_VALIDATION CHAC subcommand 


CHANGE. CLIENT. VALIDATION CHAC 
subcommand 4-14 
CHANGE _ CLIENT_VALIDATION CHAS 
subcommand 4-15 
CHANGE_ CLIENT. VALIDATION DEFC 
subcommand 4-14 
CHANGE_CLIENT_ VALIDATION DEFS 
subcommand 4-15 
CHANGE CONNECTION _ 
CHAC subcommand 4-16 
CHANGE_CONNECTION_ 
CHAS subcommand 4-17 
CHANGE. CONNECTION _PRIORITY 
DEFC subcommand 4-16 
CHANGE_.CONNECTION 
DEFS subcommand 4-17 
CHANGE. MAXIMUM._§CONNECTIONS 
CHAC subcommand 4-18 
CHANGE. MAXIMUM._§CONNECTIONS 
CHAS subcommand 4-19 
CHANGE_ MAXIMUM CONNECTIONS 
DEFC subcommand 4-18 
CHANGE._MAXIMUM_§CONNECTIONS 
DEFS subcommand 4-19 
CHANGE_NAM_ ATTRIBUTES 
command 7-2 
CHANGE_SERVER_JOB CHAS 
subcommand 4-21 
CHANGE_SERVER_JOB DEFS 
subcommand 4-21 
CHANGE_SERVER MANNA 
subcommand 4-20 
CHANGE SERVER _ VALIDATION 
CHAS subcommand 4-23 
CHANGE_SERVER VALIDATION DEFS 
subcommand 4-23 
Client address attribute 3-15 
Client application attributes 3-11 
Client capability attribute 3-13 
Client information source attribute 3-16 
Client ring attribute 3-13 
Client system privilege attribute 3-14 
Client validation attribute 3-16 
Clock Management Entity 
Activating 6-4 
Deactivating 6-10 
Description 6-2 
Command and Alarm Management 
Entity 6-2 
Connection priority attribute 
Client 3-14 
Server 3-16 
Connection request validation 
Client identity 2-9 . 
Network address 2-10 


PRIORITY 
PRIORITY 


PRIORITY 
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DELETE_BTFS subcommand 


D 


DEACTIVATE_BTFS command 5-54 
DEACTIVATE_CLIENT MANNA 
subcommand 4-24 
DEACTIVATE_INETD command 5-55 
DEACTIVATE.. NETWORK CLOCK 
command 6-10 
DEACTIVATE__ NETWORK _ FILE 
ACCESS command 6-11 
DEACTIVATE_ NETWORK INITIALIZER 
command 6-12 
DEACTIVATE_NETWORK_§LOG 
command 6-13 
DEACTIVATE_NFS command 5-56 
DEACTIVATE_ NTF command 5-57 
DEACTIVATE_ NTF_ MAIL 
command 5-58 
DEACTIVATE..PCNFSD command _ 5-59 
DEACTIVATE._.PORTMAP 
command 5-60 
DEACTIVATE_PTF command 5-61 
DEACTIVATE_QTF command 5-62 
DEACTIVATE_QTFS command 5-63 
DEACTIVATE_SCF command 5-64 
DEACTIVATE_SCFS command 5-65 
DEACTIVATE_ SERVER MANNA 
subcommand 4-25 
DEACTIVATE_SMTP command _ 5-66 
DEFINE_ APPLICATION. NAME _ 
SWITCH directive 8-12 
DEFINE_BTF subcommand 5-3 
DEFINE_BTFS subcommand 5-4 
DEFINE_CLIENT MANNA 
subcommand 4-26 
DEFINE_ DESKTOP_ENVIRONMENT 
subcommand 5-5 
DEFINE_ DESTINATION _ 
directive 8-13 
DEFINE_ DESTINATION _ NAME _ 
SWITCH directive 8-14 
DEFINE_FTP subcommand 5-6 
DEFINE_FTPS subcommand 5-7 
DEFINE IPC. APPLICATIONS 
subcommand 5-8 


GROUP_ 


* DEFINE_NTF subcommand 5-9 


DEFINE_OPENTF subcommand 5-10 
DEFINE_OPES subcommand 5-11 
DEFINE_PTF subcommand 5-12 
DEFINE_QTF subcommand 5-13 
DEFINE_QTFS subcommand 65-14 
DEFINE_SCF subcommand 5-15 
DEFINE_SCFS subcommand 5-16 
DEFINE_SERVER MANNA 
subcommand 4-27 
DEFINE_SMTP subcommand 5-17 
DEFINE_SMTPS subcommand 5-18 
DEFINE_.SOURCE_NAME_ SWITCH 
directive 8-15 
DELETE_BTF subcommand 5-19 
DELETE_BTFS subcommand 5-20 
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DELETE_CLIENT_ADDRESS CHAS subcommand 


DELETE. CLIENT. ADDRESS CHAS 
subcommand 4-30 

DELETE_CLIENT_ADDRESS DEFS 
subcommand 4-30 

DELETE_CLIENT MANNA 
subcommand 4-29 

DELETE_DESKTOP_EN VIRONMENT 
subcommand 5-21 

DELETE_FTP subcommand 5-22 
DELETE_FTPS subcommand 5-23 
DELETE_IPC_APPICATIONS 
subcommand 5-24 

DELETE_NTF subcommand 5-25 
DELETE_OPENTF subcommand 5-26 
DELETE_OPES subcommand 5-27 
DELETE_PTF subcommand 5-28 
DELETE_QTF subcommand 5-29 
DELETE_QTFS subcommand 5-30 
DELETE_SCF subcommand 5-31 

DELETE_SCFS subcommand 5-32 
DELETE SERVER_MANAGED_ TITLE 
CHAS subcommand 4-32 

DELETE. SERVER. MANAGED_ TITLE 
DEFS subcommand 4-32 
DELETE_SERVER MANNA 
subcommand 4-31 

DELETE_SMTP subcommand 5-33 
DELETE_SMTPS subcommand 5-34 
DELETE_TITLE CHAS 
subcommand 4-33 

DELETE_TITLE DEFS 
subcommand 4-33 

Desktop Environment services 

Default definition for C-1 
Description 2-15 

Desktop/VE C-1 

Directives file 8-1 

DISPLAY_ APPLICATION _ STATUS 
MANNA subcommand 4-34 
DISPLAY_.CLIENT_ATTRIBUTE CHAC 
subcommand 4-35 
DISPLAY_CLIENT_ATTRIBUTE DEFC 
subcommand 4-35 

DISPLAY. CLIENT_ATTRIBUTE 
MANNA subcommand 4-35 
DISPLAY. CLIENT_STATUS MANNA 
subcommand 4-37 
DISPLAY_NAM_ATTRIBUTES 
command 7-5 

DISPLAY_SERVER_ATTRIBUTE CHAS 
subcommand 4-38 

DISPLAY_SERVER_ATTRIBUTE DEFS 
subcommand 4-38 

DISPLAY_SERVER_ATTRIBUTE 
MANNA subcommand 4-38 

DISPLAY_SERVER_STATUS MANNA 
subcommand — 4-40 

DISPLAY_STORE_ FORWARD 
NETWORK subcommand 8-5 
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Interprocess Communication services 


E 


END_CHANGE_CLIENT CHAC 
subcommand 4-41 

END_CHANGE_SERVER CHAS 
subcommand 4-42 

END_DEFINE_CLIENT DEFC 
subcommand 4-43 

END..DEFINE_SERVER DEFS 
subcommand 4-44 

Error messages D-1 


F 


File Access Management Entity 
Activating 6-5 
Deactivating 6-11 
Description 6-1 

File Transfer Protocol services 
Default definition for C-6 
Description 2-20 

FTP 2-20; C-6 

FTP/VE 2-20 

FTPS 2-20 


G 


GENERATE. APPLICATION _ 
DEFINITION MANNA 
subcommand 4-45 
GENERATE CLIENT_ DEFINITION 
CHAC subcommand 4-46 
GENERATE _CLIENT_ DEFINITION 
DEFC subcommand 4-46 
GENERATE. CLIENT_ DEFINITION 
MANNA subcommand 4-46 
GENERATE_SERVER_ DEFINITION 
CHAS subcommand 4-47 
GENERATE_SERVER_ DEFINITION 
DEFS subcommand 4-47 
GENERATE. SERVER DEFINITION 
MANNA subcommand 4-47 
GENERATE STORE_ FORWARD 
NETWORK subcommand 8-7 


I 


Initialization Management enhy. 
Activating 6-7 
Deactivating 6-12 
Description 6-1 
INSTALL_STORE_ FORWARD 
NETWORK subcommand 8-8 
Interprocess Communication services 
Default definition for C-7 
Description 2-21 
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Log Management Entity 


L 


Log Management Entity 
Activating 6-8 
Deactivating 6-13 
Description 6-1 


M 


MANAGE_APPLICATION_ 
DEFINITIONS command 5-2 
MANAGE_ APPLICATION _ 
DEFINITIONS utility 5-1 
Manage CDCNET Configuration 
(MANCC) 6-14 
MANAGE. NETWORK~_APPLICATION 
command 4-2 
MANAGE_NETWORK~_APPLICATIONS 
utility 
Command and subcommands 4-1 
Introduction 3-1 
Prerequisites 3-3 
Restrictions 3-3 
MANAGE_STORE_FORWARD_ 
NETWORK command 8-4 
MANAGE_STORE_ FORWARD. 
NETWORK utility 
Accessing a store-and-forward network 
file 8-3 
Command and subcommands 8-3 
Creating a store-and-forward network 
file 8-2 
Directives 8-11 
Directives file 8-1 
Error messages D-1 
Examples 8-16 
Introduction 8-1 
Network file 8-1 
Updating a store-and-forward network 
file 8-3 
Management Entities 
Activating and deactivating 6-3 
Changing parameter values for 6-3 
Description 6-1 
MANSFN utility 8-1 
Maximum connections attribute 
Client 3-14 
Server 3-17 


N 


NAM- initiated attribute 3-17 
NAM/VE attribute commands 
CHANGE._NAM_ATTRIBUTES 7-2 
DISPLAY_NAM_ATTRIBUTES | 7-5 
NAM/VE attributes 7-1 
Network address 
Components 2-4 
Description 2-4 
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Printed manuals, ordering 


Network application 
Changing 3-5 
Client 2-2 
Concepts 2-2 
Default definitions C-1 
Defining 3-4 
Displaying attributes of 3-9 
Displaying status of 3-8 
Installation commands 65-1 
Multiconnection 2-4 
Redefining 3-6 
Server 2-2 
Single-connection 2-3 
System defined 2-14 
Validation 2-7 
Network directory 
Assigning server titles 2-10 
Description 2-10 
Search for server titles 2-13 
Server title registration 2-12 
Network file 8-1 
Network File System 2-21 
Network management on NOS/VE 1-1 
Network management utilities 
CDCNET Network Configuration 6-14 
Description 6-14 
Manage CDCNET Configuration 6-14 
Network Operator Utility 6-14 
Network Performance Analyzer 6-14 
Network Operator Utility (NETOU) 6-14 
Network Performance Analyzer 
(NPA) 6-14 
Network Transfer Facility services 
Default definition for C-5 
Description 2-18 
NFS 2-21 
NFS/VE 2-21 
NTF 2-18; C-5 


O 


Online manuals, accessing B-1 

OPENTF 2-19; C-6 

Operate Network Transfer Facility 
Default difinition for C-6 
Description 2-19 

OPERATE_STATION utility 
Default definition for C-4 
Description 2-17 

OPES 2-17; C-4 

Ordering printed manuals B-1 


P 
PC-NFS 2-21 
PCNFSD 2-21 


Permanent File Transfer Facility services 
Default definition for C-1 | 
Description 2-16 

Printed manuals, ordering B-1 
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Protocol attribute 


Protocol attribute 
Client 3-14 
Server 3-17 

PTF 2-16; C-1 


Q 

QTF 2-16; C-2 

Queue File Transfer Facility services 
Default definition for C-2 
Description 2-16 

QUIT MANNA subcommand 4-48 

QUIT subcommand 5-35; 8-9 


S 


SCF 2-17, 19; C-3 
SCFS 2-17, 18; C-4 
Server application attributes 3-12 
Server application job 
Description 2-5 
NAM-initiated 2-5 
User-initiated 2-5 
Server application titles 
Assigning 2-10 
Description 2-11 
Directory searches 2-13 
Management 2-11 
Registration in network directory 2-12 
Server capability attribute 3-17 
Server job attribute 3-18 
Server job maximum connections 
attribute 3-18 
Server job validation 2-8 
Server job validation source 
attribute 3-18 
Server managed titles attribute 3-18 
Server ring attribute 3-19 
Server system privilege attribute 3-19 
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VERIFY_STORE_FORWARD_NETWORK subcommand 


Simple Mail Transfer Protocol services 
Default definition for C-7 
Description 2-20 

SMTP 2-20; C-7 

SMTP/VE 2-20 

Status and Control Facility 
Default definition for C-3 
Description 2-17, 19 

Status and Control Facility Server 
Default definition for C-4 
Description 2-17, 18 

Store-and-forward network file 8-1 

$SYSTEM.PTF_QTF.STORE_ 

FORWARD_NETWORK 8-3 


T 


Timesharing services 
Default definition for C-1 
Description 2-14 

Title 
Management 2-11 
Pattern definition 2-11 
Priority 2-13 
Registration 2-12 

Title attribute 3-19 

Title data attribute 3-19 

Title priority attribute 3-19 

Title (see Server application titles) 2-11 


V . 
Validation 
Connection request 2-9 
Network application 2-7 
Server job 2-8 
VERIFY_STORE_FORWARD_ 
NETWORK subcommand 8-10 
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We would like your comments on this manual to help us improve it. Please take a few minutes to fill out 
this form. 


Who are you? © How do you use this manual? 
0 Manager O As an overview 

CO Systems analyst or programmer 0 To learn the product or system 
0 Applications programmer O For comprehensive reference 

O Operator D For quick look-up 

O Other 0 Other 


What programming languages do you use? 


How do you like this manual? Answer the questions that apply. 

Yes Somewhat No 

Does it tell you what you need to know about the topic? 

Is the technical information accurate? 

Is it easy to understand? 

Is the order of topics logical? 

Can you easily find what you want? 

Are there enough examples? 

Are the examples helpful? (0 Too simple? © Too complex?) 
Do the illustrations help you? 

Is the manual easy to read (print size, page layout, and so on)? 
Do you use this manual frequently? 


gnoao0d00ng0go0g0ag od 
noaaaqgqangcadaaoaga 
noaoao0oo0oaagoao0od 


Comments? If applicable, note page and paragraph. Use other side if needed. 


Check here if you want a reply: oO 


ame Company 
Address Date 
one 


Please send program listing and output if applicable to your comment. 
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